Développeurs de l'Espace économique européen (EEE)
Vous pouvez utiliser le SDK Places pour iOS et l'API Geocoding avec le SDK Maps pour iOS afin de rechercher des régions et d'obtenir plus d'informations sur les lieux. Le SDK Places pour iOS et l'API Geocoding sont des alternatives puissantes 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
Le service 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 sur GMSAutocompleteFilter.
Obtenir des détails sur un lieu pour une région
Les données Détails sur un lieu pour 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 identifiant 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 (avec des caractères d'échappement d'URL) pour envoyer une requête à l'API Geocoding :
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 :
En utilisant le geocoding inversé avec le filtrage par composants, vous pouvez 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 :
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eYou can search for and get information about regions using the Places SDK for iOS and the Geocoding API with the Maps SDK for iOS.\u003c/p\u003e\n"],["\u003cp\u003eThe Places API Text Search and Autocomplete service enable searching for regions based on text strings and user input.\u003c/p\u003e\n"],["\u003cp\u003ePlace Details provide comprehensive information about regions, including boundary place IDs, viewport for zooming, and feature type.\u003c/p\u003e\n"],["\u003cp\u003eThe Geocoding API facilitates converting addresses and coordinates into geographic coordinates and vice-versa, useful for retrieving viewport, place IDs, and address components.\u003c/p\u003e\n"],["\u003cp\u003eReverse geocoding with the Geocoding API allows finding place IDs based on latitude and longitude coordinates and applying component filtering for specific address types.\u003c/p\u003e\n"]]],[],null,["Select platform: [Android](/maps/documentation/android-sdk/dds-boundaries/dds-use-maps-places-apis \"View this page for the Android platform docs.\") [iOS](/maps/documentation/ios-sdk/dds-boundaries/dds-use-maps-places-apis \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/dds-boundaries/dds-use-maps-places-apis \"View this page for the JavaScript platform docs.\")\n\n\u003cbr /\u003e\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nYou can use the Places SDK for iOS and the\nGeocoding API with the Maps SDK for iOS to\nsearch for regions, and get more information about places. The\nPlaces SDK for iOS and Geocoding API\nare powerful and stable alternatives for obtaining [place\nIDs](/maps/documentation/places/ios-sdk/place-id). If you're already using place\nIDs, you can reuse those IDs with data-driven styling for boundaries.\n\nAdd Places and Geocoding to your Maps SDK for iOS apps in the following ways:\n\n- [Places SDK for iOS](/maps/documentation/places/ios-sdk) returns information about places using HTTP requests.\n- [CLGeocoder](https://developer.apple.com/documentation/corelocation/clgeocoder) class can geocode and reverse geocode dynamically from user input.\n- [Geocoding API](/maps/documentation/geocoding) lets you geocode static, known addresses.\n\n| **Note:** The [Places SDK for iOS](/maps/documentation/places/ios-sdk) and Geocoding API must be enabled, and are billed separately from the Maps SDK for iOS.\n\nUse the Places API\n\n- The [Places API Text\n Search](/maps/documentation/places/web-service/text-search) returns\n information about a set of places based on a string --- for example \"pizza in\n New York\" or \"shoe stores near Ottawa\" or \"123 Main Street\". The service\n responds with a list of places matching the text string and any location\n bias that has been set.\n\n- The [Places Autocomplete](/maps/documentation/places/ios-sdk/autocomplete#restrict_results_to_a_specific_region) service provides a convenient\n way to let your users search for regions. To display results within the\n defined region, set `locationRestriction` on\n [`GMSAutocompleteFilter`](/maps/documentation/places/ios-sdk/reference/objc/Classes/GMSAutocompleteFilter).\n\nGet place details for a region\n\n- The [Place Details](/maps/documentation/places/ios-sdk/place-details) data\n for a region is also effective. For example, you can:\n\n - Search for boundary place IDs based on place names.\n - Get the viewport for zooming to a boundary.\n - Get the feature type for the boundary (for example locality).\n - Get the formatted address, which resolves to \"Place Name, State, Country\" in the United States region (for example, \"Kirkland, WA, USA\").\n - Get other useful data such as photos.\n\nUse the Geocoding API\n\n- The [Geocoding API](/maps/documentation/geocoding) lets you\n convert an address, latitude and longitude coordinates, or place ID into\n geographic coordinates, and vice-versa. The following uses combine well with\n data-driven styling for boundaries:\n\n - Use Geocoding to get the viewport for a region.\n - Apply component filtering to your Geocoding call to get the place IDs for administrative areas 1-4, locality, or postal code.\n - Use reverse geocoding to find place IDs by latitude and longitude coordinates, or even return place IDs for all components in a particular location.\n\n The following example uses an address (url-escaped) to make a request to the\n Geocoding API: \n\n ```html\n https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY\n ```\n\n You can use [reverse\n geocoding](/maps/documentation/geocoding/requests-reverse-geocoding) to\n find place IDs. The following example Geocoding service function returns the\n place IDs for all address components at the specified latitude and longitude\n coordinates: \n\n ```html\n https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY\n ```\n\n Use reverse geocoding with component filtering to get the address component\n for one or more of the following types at the specified location:\n - `administrativeArea`\n - `country`\n - `locality`\n - `postalCode`\n - `schoolDistrict`\n\n The following example shows using the Geocoding service, adding component\n restrictions with reverse geocoding to retrieve all address components\n at the specified location for the `locality` type: \n\n ```html\n https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY\n ```"]]
