Vous pouvez utiliser le SDK Places pour iOS et l'API Geocoding avec le SDK Maps pour iOS pour rechercher des régions et obtenir plus d'informations sur les lieux. Le SDK Places pour iOS et l'API Geocoding constituent des solutions performantes et stables pour obtenir des ID de lieu. Si vous utilisez déjà des ID de lieu, vous pouvez les réutiliser avec le style basé sur les données pour les limites.
Vous pouvez ajouter Places et Geocoding à vos applications du SDK Maps pour iOS comme suit:
- Le SDK Places pour iOS affiche des informations sur les lieux à l'aide de requêtes HTTP.
- La classe CLGeocoder 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 l'API Places
Text Search de l'API Places renvoie des informations sur un ensemble de lieux en fonction d'une chaîne, par exemple "pizza à New York", "magasin de chaussures près d'Ottawa" ou "123 Main Street". Ce service renvoie une liste des lieux correspondant à la chaîne de texte et aux limitations de zone géographique définis.
Le service Place Autocomplete permet aux utilisateurs de rechercher facilement des régions. Pour afficher les résultats dans la région définie, définissez
locationRestriction
surGMSAutocompleteFilter
.
Obtenir des détails sur un lieu pour une région
Les données Détails sur un lieu d'une région sont également efficaces. 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, localité) ;
- obtenir l'adresse formatée, qui correspond à "Nom du lieu, État, Pays" dans la région des États-Unis (par exemple, "Kirkland, WA, USA") ;
- obtenir d'autres données utiles, comme des photos.
Utiliser l'API Geocoding
L'API Geocoding vous permet de convertir une adresse, des coordonnées de latitude et de longitude ou un ID de lieu en coordonnées géographiques, et inversement. 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.
- Le geocoding inversé permet de trouver des ID de lieu à partir de coordonnées de latitude et de longitude, ou même d'afficher les ID de lieu de tous les composants d'un lieu donné.
L'exemple suivant utilise une adresse (encodée en URL) pour envoyer une requête à l'API Geocoding:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY
Vous pouvez utiliser le geocoding inversé pour trouver des ID de lieu. L'exemple de fonction de service Geocoding suivant renvoie les ID de lieu pour tous les composants d'adresse aux coordonnées de latitude et de longitude spécifiées:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY
Utilisez 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
schoolDistrict
L'exemple suivant montre comment utiliser le service Geocoding, en ajoutant des restrictions de composants avec geocoding inversé pour récupérer tous les composants d'adresse à l'emplacement spécifié pour le type
locality
:https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY