Puoi utilizzare Places SDK for iOS e l'API Geocoding con Maps SDK for iOS per cercare regioni e ottenere maggiori informazioni sui luoghi. Places SDK for iOS e l'API Geocoding sono alternative potenti e stabili per ottenere gli ID luogo. Se utilizzi già gli ID luogo, puoi riutilizzarli con lo stile basato sui dati per i confini.
Aggiungi Places e Geocoding alle tue app Maps SDK per iOS nei seguenti modi:
L'SDK Places per iOS
restituisce informazioni sui luoghi utilizzando le richieste HTTP.
La classe CLGeocoder
può eseguire la geocodifica e la geocodifica inversa in modo dinamico a partire dall'input dell'utente.
L'API Geocoding ti consente di
geocodificare indirizzi statici noti.
Utilizzare l'API Places
La Places API Text
Search restituisce
informazioni su un insieme di luoghi in base a una stringa, ad esempio "pizza a
New York" o "negozi di scarpe vicino a Ottawa" o "123 Main Street". Il servizio
risponde con un elenco di luoghi corrispondenti alla stringa di testo e a qualsiasi bias di località
che è stato impostato.
Il servizio Place Autocomplete offre un modo pratico per consentire agli utenti di cercare regioni. Per visualizzare i risultati all'interno della regione definita, imposta locationRestriction su GMSAutocompleteFilter.
Visualizzare i dettagli di un luogo per una regione
Sono efficaci anche i dati Place Details
per una regione. Ad esempio, puoi:
Cerca gli ID luogo del confine in base ai nomi dei luoghi.
Ottieni l'area visibile per lo zoom su un confine.
Ottieni il tipo di funzionalità per il confine (ad esempio, località).
Ottieni l'indirizzo formattato, che si risolve in "Nome luogo, Stato,
Paese" nella regione degli Stati Uniti (ad esempio, "Kirkland, WA, USA").
Ricevi altri dati utili, come le foto.
Utilizzare l'API Geocoding
L'API Geocoding ti consente di
convertire un indirizzo, le coordinate di latitudine e longitudine o l'ID luogo in
coordinate geografiche e viceversa. I seguenti utilizzi si combinano bene con
gli stili basati sui dati per i confini:
Utilizza il geocoding per ottenere la visualizzazione per una regione.
Applica il filtro dei componenti alla chiamata di geocodifica per ottenere gli ID luogo
per le aree amministrative 1-4, la località o il codice postale.
Utilizza la geocodifica inversa per trovare gli ID luogo in base alle coordinate di latitudine e longitudine o per restituire gli ID luogo per tutti i componenti di una determinata località.
L'esempio seguente utilizza un indirizzo (con escape URL) per inviare una richiesta all'API Geocoding:
Puoi utilizzare la geocodifica
inversa per
trovare gli ID luogo. La seguente funzione di esempio del servizio Geocoding restituisce gli ID luogo per tutti i componenti dell'indirizzo alle coordinate di latitudine e longitudine specificate:
Utilizza il geocoding inverso con il filtro dei componenti per ottenere il componente indirizzo
per uno o più dei seguenti tipi nella località specificata:
administrativeArea
country
locality
postalCode
schoolDistrict
L'esempio seguente mostra l'utilizzo del servizio di geocodifica, l'aggiunta di limitazioni dei componenti con la geocodifica inversa per recuperare tutti i componenti dell'indirizzo nella località specificata per il tipo locality:
[null,null,["Ultimo aggiornamento 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 ```"]]
