Gli ID luogo identificano in modo univoco un luogo nel database di Google Places e su Google Maps. Gli ID luogo sono accettati nelle richieste alle seguenti API di Google Maps:
- Recupero di un indirizzo per un ID luogo nel servizio web e Geocoding nell'API Geocoding, API Maps JavaScript.
- Specificare origine, destinazione e tappe intermedie nel servizio web dell'API Routes e nell'API Directions e nel servizio Directions, nell'API Maps JavaScript.
- Specificare origini e destinazioni nel servizio web API Routes e nell'API Distance Matrix e nel servizio Distance Matrix, nell'API Maps JavaScript.
- Recupero dei dettagli dei luoghi nel servizio web API Places, SDK Places per Android, SDK Places per iOS e libreria di Places.
- Utilizzo dei parametri ID luogo nell'API Maps Embed.
- Recupero delle query di ricerca negli URL di Maps.
- Visualizzazione dei limiti di velocità nell'API Roads.
- Trovare e assegnare uno stile ai poligoni dei confini negli stili basati sui dati per i confini.
Trovare l'ID di un luogo specifico
Stai cercando l'ID luogo di un luogo specifico? Utilizza lo strumento di ricerca ID luogo di seguito per cercare un luogo e recuperarne l'ID:
In alternativa, puoi visualizzare lo strumento di ricerca degli ID luogo con il relativo codice nella documentazione dell'API Maps JavaScript.
Panoramica
Un ID luogo è un identificatore testuale che identifica in modo univoco un luogo. La lunghezza dell'identificatore può variare (non esiste una lunghezza massima per gli ID luogo). Esempi:
-
ChIJgUbEo8cfqokR5lP9_Wh_DaM -
GhIJQWDl0CIeQUARxks3icF8U8A -
EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0EiGhIYChQKEgnRTo6ixx-qiRHo_bbmkCm7ZRAN -
EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0E -
IhoSGAoUChIJ0U6OoscfqokR6P225pApu2UQDQ
Gli ID luogo sono disponibili per la maggior parte delle sedi, incluse attività, punti di riferimento, parchi e incroci. È possibile che uno stesso luogo o località abbia più ID luogo diversi. Gli ID dei luoghi potrebbero cambiare nel tempo.
Puoi utilizzare lo stesso ID luogo nell'API Places e in diverse API Google Maps Platform. Ad esempio, puoi utilizzare lo stesso ID luogo per fare riferimento a un luogo nell'API Places, nell'API Maps JavaScript, nell'API Geocoding, nell'API Maps Embed e nell'API Roads.
Recuperare i dettagli del luogo utilizzando l'ID luogo
Un modo comune per utilizzare gli ID luogo è cercare un luogo (ad esempio mediante l'API Places o la libreria Places nell'API Maps JavaScript) e poi utilizzare l'ID luogo restituito per recuperare i dettagli del luogo. Puoi archiviare l'ID luogo e utilizzarlo per recuperare gli stessi dettagli in un secondo momento. Scopri di più sul salvataggio degli ID luogo di seguito.
I seguenti esempi mostrano come richiedere l'URL di un'icona per l'API Places (nuova) e l'API Places.
API Places (Novità)
Utilizzando l'API Places, puoi trovare l'ID luogo eseguendo una richiesta Text Search (New).
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.id,places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'
La risposta include un ID luogo nel campo id, come mostrato di seguito:
{
"places": [
{
"id": "ChIJs5ydyTiuEmsR0fRSlU0C7k0",
"formattedAddress": "29 King St, Sydney NSW 2000, Australia",
"displayName": {
"text": "Peace Harmony",
"languageCode": "en"
}
},
...
}
Ora puoi effettuare una richiesta per Place Details (novità) includendo l'ID luogo nell'URL della richiesta:
https://places.googleapis.com/v1/places/ChIJs5ydyTiuEmsR0fRSlU0C7k0?fields=id,displayName&key=API_KEY
API Places
Utilizzando l'API Places, puoi trovare l'ID di un luogo effettuando una richiesta Place Search.
L'esempio seguente è una richiesta di ricerca di luoghi di tipo "ristorante" entro un raggio di 1500 metri da un punto di Sydney, in Australia, contenenti la parola "crociera":
https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=1500&type=restaurant&keyword=cruise&key=YOUR_API_KEY
La risposta include un ID luogo nel campo place_id, come mostrato in questo snippet:
{
"html_attributions" : [],
"results" : [
{
"geometry" : {
"location" : {
"lat" : -33.870775,
"lng" : 151.199025
}
},
...
"place_id" : "ChIJrTLr-GyuEmsRBfy61i59si0",
...
}
],
"status" : "OK"
}
Ora puoi inviare una
richiesta Place Details,
inserendo l'ID luogo nel parametro place_id:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0&key=YOUR_API_KEY
Salva gli ID dei luoghi per utilizzarli in un secondo momento
Gli ID luogo sono esenti dalle limitazioni di memorizzazione nella cache stabilite nella Sezione 3.2.3(b) dei Termini di servizio di Google Maps Platform. Puoi quindi archiviare i valori degli ID luogo per utilizzarli in un secondo momento.
Aggiornamento degli ID dei luoghi memorizzati
Ti consigliamo di aggiornare gli ID luogo se risalgono a più di 12 mesi fa. Puoi
aggiornare gli ID luogo senza costi aggiuntivi effettuando una
richiesta Place Details, specificando solo il campo ID
nel parametro fields.
API Places (Novità)
Ad esempio, utilizzando Place Details (New) (Dettagli luogo (nuovo)):
https://places.googleapis.com/v1/places/ChIJ05IRjKHxEQ0RJLV_5NLdK2w?fields=id&key=API_KEY
API Places
Ad esempio, utilizzando l'API Place Details precedente:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJ05IRjKHxEQ0RJLV_5NLdK2w&fields=place_id&key=API_KEY
Questa richiesta potrebbe restituire anche il codice di stato NOT_FOUND. Una strategia consiste nell'archiviare la richiesta originale che ha restituito ogni ID luogo. Se un ID luogo non è più valido, puoi emettere nuovamente la richiesta per ricevere risultati aggiornati. Questi risultati potrebbero includere o meno il luogo originale. Tuttavia, questa richiesta è addebitabile.
Codici di errore quando si utilizzano gli ID luogo
Il codice di stato INVALID_REQUEST indica che l'ID luogo specificato non è valido. INVALID_REQUEST può essere restituito quando
l'ID luogo è stato troncato o modificato in altro modo e non è più corretto.
Il codice di stato NOT_FOUND indica che l'ID luogo specificato è obsoleto. Un ID luogo può diventare obsoleto se un'attività chiude o si sposta in una nuova sede. Gli ID luogo potrebbero cambiare a causa di aggiornamenti su larga scala nel database di Google Maps. In questi casi, un luogo potrebbe ricevere un nuovo ID luogo e quello precedente restituisce una risposta NOT_FOUND.
In particolare, alcuni tipi di ID luogo a volte possono causare una risposta NOT_FOUND oppure l'API potrebbe restituire un ID luogo diverso nella risposta. Questi tipi di ID luogo includono:
- Indirizzi che non esistono in Google Maps come indirizzi precisi, ma che vengono dedotti da un intervallo di indirizzi.
- Segmenti di un percorso lungo in cui la richiesta specifica anche una città o una località.
- Incroci.
- Luoghi con un componente indirizzo di tipo
subpremise.
Questi ID spesso assumono la forma di una lunga stringa (non esiste una lunghezza massima per gli ID luogo). Ad esempio:
EpID4LC14LC_4LCo4LCv4LGN4LCo4LCX4LCw4LGNIC0g4LC44LGI4LCm4LGN4LCs4LC-4LCm4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSAmIOCwteCwv-CwqOCwr-CxjSDgsKjgsJfgsLDgsY0g4LCu4LGG4LCv4LC_4LCo4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSwg4LC14LC_4LCo4LCv4LGNIOCwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwsuCwleCxjeCwt-CxjeCwruCwv-CwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwuOCwsOCxguCwsOCxjSDgsKjgsJfgsLDgsY0g4LC14LGG4LC44LGN4LCf4LGNLCDgsLjgsK_gsYDgsKbgsL7gsKzgsL7gsKbgsY0sIOCwueCxiOCwpuCwsOCwvuCwrOCwvuCwpuCxjSwg4LCk4LGG4LCy4LCC4LCX4LC-4LCjIDUwMDA1OSwg4LCt4LC-4LCw4LCk4LCm4LGH4LC24LCCImYiZAoUChIJ31l5uGWYyzsR9zY2qk9lDiASFAoSCd9ZebhlmMs7Efc2NqpPZQ4gGhQKEglDz61OZpjLOxHgDJCFY-o1qBoUChIJi37TW2-YyzsRr_uv50r7tdEiCg1MwFcKFS_dyy4