@kreonovo/places-autocomplete-svelte
v2.0.9
Published
A lightweight and customizable Svelte component for easy integration of Google Maps Places Autocomplete (New API) in your Svelte/SvelteKit applications. Provides accessible autocomplete suggestions and detailed address retrieval.
Maintainers
Readme
Places Autocomplete Svelte
This Svelte component leverages the Google Maps Places Autocomplete API to provide a user-friendly way to search for and retrieve detailed address information within your SvelteKit applications.
Preview this package Demo
Features:
- Seamless Integration: Easily integrate the component into your SvelteKit projects.
- Autocomplete Suggestions: Provide users with real-time suggestions as they type, enhancing the search experience.
- Detailed Address Retrieval: Retrieve comprehensive address information, including street address, city, region, postal code, and country.
- Country/Region Selection: Allow users to specify a region for more targeted results.
- Customizable: Tailor the component's appearance and behavior using language settings, placeholder text.
- Accessible: Supports keyboard navigation for selecting suggestions.
Requirements
- Google Maps API Key: Create an API key with the Places API (New) enabled. Refer to Use API Keys for detailed instructions.
Installation Svelte 5
npm i places-autocomplete-svelte
Installation Svelte 4
npm i [email protected]
Basic Usage
- Provide your Google Maps API Key: Replace
'___YOUR_API_KEY___'
with your actual Google Maps API key. - Handle the Response: Use the
onResponse
callback to receive the selected place details.
<script>
import { PlaceAutocomplete } from 'places-autocomplete-svelte';
const PUBLIC_GOOGLE_MAPS_API_KEY = '___YOUR_API_KEY___';
let fullResponse = $state('')
let onResponse = (response) => {
console.log(response)
fullResponse = response;
};
</script>
<PlaceAutocomplete {onResponse} {PUBLIC_GOOGLE_MAPS_API_KEY} />
<p>Response Object: {JSON.stringify(fullResponse, null, 2)}</p>
Countries/Regions
Use optional countries
property to refine search by region:
<script>
// ... other imports
let countries = [
{ name: 'United Kingdom', region: 'GB', language: 'en-GB' },
{ name: 'United States', region: 'US', language: 'en-US' }
// ... more countries
];
</script>
<PlaceAutocomplete {onResponse} {PUBLIC_GOOGLE_MAPS_API_KEY} bind:countries/>
- The
region
code follows the CLDR two-character format. - The
language
in which to return results. See details
Error Handling
The component will throw an error if:
- The Google Maps API key is invalid or missing.
- There are network issues connecting to the Google Maps service.
Handle these errors gracefully in your application:
<script>
// ... other imports
// Error handler
let pacError = '';
let onError = (error: string) => {
console.error(error);
pacError = error;
};
</script>
<PlaceAutocomplete {onError} {onResponse} {PUBLIC_GOOGLE_MAPS_API_KEY} />
{#if pacError}
<p class="error">{pacError}</p>
{/if}
Customization
- Placeholder: Use the placeholder property to customize the input field's placeholder text.
- Language: Use the language property to set the language of the autocomplete results.
- Region: Use the region property to bias the results toward a particular region. If the countries array is provided the region will be used from the selected country.
- Autocomplete: Use to disable the input autocomplete.
<script>
// ... other imports
const placeholder = 'Search...';
const language = 'en-GB';
const region = 'GB';
const autocompete = 'off';
</script>
<PlaceAutocomplete {onError} {onResponse} {PUBLIC_GOOGLE_MAPS_API_KEY} bind:countries {placeholder} {language} {region} {autocomplete}/>
Contributing
Contributions are welcome! Please open an issue or submit a pull request on the GitHub repository.