Utiliser le service Places et l'API Geocoding avec un style basé sur les données pour les limites

Sélectionnez une plate-forme : Android iOS JavaScript

Vous pouvez utiliser le service Places et l'API Geocoding avec le SDK Maps pour Android afin de rechercher des régions ; pour obtenir plus d'informations sur des lieux. Le service Places et l'API Geocoding sont des alternatives puissantes et stables pour obtenir ID de lieu. Si vous utilisez déjà des ID de lieu, vous pouvez les réutiliser avec styles basés sur les données pour les limites.

Ajoutez le service Places et Geocoding à votre SDK Maps pour les applications Android:

  • SDK Places pour Android est une bibliothèque Android contenant des méthodes pour renvoyer des informations à différents endroits.
  • L'API Places affiche des informations sur les lieux à l'aide de requêtes HTTP.
  • Classe Geocoder peut effectuer un geocoding et un geocoding inversé de manière dynamique à partir d'une entrée utilisateur.
  • L'API Geocoding vous permet de géocoder des adresses statiques connues.

Utiliser le service Places

Utiliser Text Search (nouvelle version) pour trouver un ID de lieu

Vous pouvez utiliser Text Search (nouvelle version). API REST dans l'API Places pour obtenir un ID de lieu qui inclut la région en spécifiant places.id dans le masque de champ. Utilisation du Text Search (nouvelle version) pour demander des ID de lieu n'engendre que sans frais. En savoir plus

Par exemple, pour obtenir l'ID de lieu de Trinidad (Californie), vous pouvez effectuer les opérations suivantes : Appel d'API:

curl -X POST -d '{
  "textQuery" : "Trinidad, CA"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'

Utiliser Place Autocomplete pour rechercher des régions

Place Autocomplete du SDK Places pour Android est un moyen pratique lorsque vos utilisateurs recherchent des régions. Pour configurer le service Places Autocomplete de façon à ne renvoie que des régions, utilisez AutocompleteSupportFragment.setTypesFilter(List) pour définir le filtre de type sur PlaceTypes.REGIONS.

Obtenir des détails sur un lieu pour une région

Place Details dans le SDK Places pour Android renvoie les données d'une région : très utile. Par exemple, vous pouvez :

  • rechercher des ID de lieu de limites en fonction de noms de lieux ;
  • obtenir la fenêtre d'affichage pour zoomer sur une limite ;
  • obtenir le type d'élément cartographique de la limite (par exemple, locality) ;
  • Obtenir l'adresse formatée, qui correspond à "Nom du lieu, État, Pays" dans Région des États-Unis (par exemple, "Ottumwa, IA, USA")
  • obtenir d'autres données utiles, comme des photos.

Utiliser l'API Geocoding

L'API Geocoding vous permet de convertir une adresse en coordonnées de latitude et de longitude et en identifiant de lieu, ou convertit ses coordonnées de latitude et de longitude ou un identifiant de lieu dans une adresse. Les utilisations suivantes se combinent bien avec un style basé sur les données pour les limites :

  • Utilisez Geocoding pour obtenir la fenêtre d'affichage d'une région.
  • Appliquez un filtrage par composants à votre appel Geocoding pour obtenir les ID de lieu des régions administratives 1 à 4, des localités ou des codes postaux.
  • Utiliser le geocoding inversé pour trouver des ID de lieu par latitude et longitude des coordonnées, ou même renvoyer des identifiants de lieu pour tous les composants d'une l'emplacement.

L'exemple suivant utilise une adresse (avec caractères d'échappement d'URL) pour envoyer une requête au API Geocoding:

https://maps.googleapis.com/maps/api/geocode/json?address=1600%20Amphitheatre%20Pkwy%20Mountain%20View%20CA&key=YOUR_API_KEY

Vous pouvez utiliser le geocoding inversé pour trouver des ID de lieu. L'exemple de geocoding suivant renvoie les ID de lieu pour tous les composants d'adresse au niveau de latitude et de longitude spécifiées:

https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY

Utiliser le geocoding inversé avec le filtrage par composants pour obtenir le composant d'adresse pour un ou plusieurs des types suivants à l'emplacement spécifié:

  • administrativeArea
  • country
  • locality
  • postalCode

L'exemple de fonction suivant illustre l'utilisation du service Geocoding, en ajoutant des restrictions de composants avec geocoding inversé pour obtenir tous les composants d'adresse à l'emplacement spécifié pour le type locality uniquement :

https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY