ID posizione

Seleziona la piattaforma: Android iOS JavaScript Servizio web

Gli ID luogo identificano in modo univoco un luogo nel database di Google Places e su Google Maps. ID luogo vengono accettati nelle richieste alle seguenti API di Google Maps:

  • Recupero di un indirizzo per un ID luogo nel servizio web dell'API Geocoding e Geocoding, API Maps JavaScript.
  • Specificare il luogo di partenza, la destinazione e le tappe intermedie nel API Routes e API Directions servizio web e servizio indicazioni stradali, API Maps JavaScript.
  • Specificare origini e destinazioni nell'API Routes e Servizio web dell'API Distance Matrix e Servizio Distance Matrix, 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 l'ID luogo di seguito per cercare un luogo e recuperare il relativo ID:

In alternativa, puoi visualizza Place ID finder con il relativo codice nell'API Maps JavaScript documentazione.

Panoramica

Un ID luogo è un identificatore testuale che identifica in modo univoco un luogo. La 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, tra cui attività, punti di riferimento, parchi e incroci. È possibile che lo stesso luogo o località hanno più ID luogo diversi. Gli ID dei luoghi potrebbero cambiare nel tempo.

Puoi utilizzare lo stesso ID luogo in tutta l'API Places di API Google Maps Platform. Ad esempio, puoi utilizzare lo stesso ID luogo per fai riferimento a un luogo nella API Places, il parametro API Maps JavaScript, l'API Geocoding, l'API Maps Embed e l'API Roads.

Recuperare i dettagli del luogo utilizzando l'ID luogo

Un modo comune di utilizzare gli ID luogo è cercare un luogo (utilizzando l'API Places o i Luoghi libreria nell'API Maps JavaScript, ad esempio), quindi utilizza la l'ID luogo restituito per recuperare i dettagli del luogo. Puoi memorizzare l'ID luogo e utilizzalo per recuperare i dettagli dello stesso luogo in un secondo momento. Informazioni salvataggio ID luogo qui sotto.

I seguenti esempi mostrano come richiedere l'URL di un'icona per l'API Places (Novità) e API Places.

API Places (Novità)

Utilizzando l'API Places, puoi trovare l'ID luogo eseguendo una Ricerca testuale (novità) richiesta.

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 creare Dettagli del luogo (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 luogo eseguendo una Richiesta di Ricerca di luoghi.

L'esempio seguente è una richiesta di ricerca di luoghi di tipo "ristorante" entro un raggio di 1500 m da un punto di Sydney, in Australia, che contiene 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, mostrate in questo snippet:

{
  "html_attributions" : [],
  "results" : [
    {
      "geometry" : {
        "location" : {
          "lat" : -33.870775,
          "lng" : 151.199025
        }
      },
      ...
      "place_id" : "ChIJrTLr-GyuEmsRBfy61i59si0",
      ...
    }
  ],
  "status" : "OK"
}

Ora puoi inviare Richiesta Dettagli luogo, inserendo l'ID del 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 dichiarate in Sezione 3.2.3(b) dei Termini di servizio di Google Maps Platform. Di conseguenza, puoi memorizzare i valori degli ID luogo per un secondo momento. per gli utilizzi odierni.

Aggiornamento degli ID dei luoghi memorizzati

Ti consigliamo di aggiornare gli ID luogo se risalgono a più di 12 mesi fa. Tu puoi aggiornare gli ID luogo senza costi eseguendo una Richiesta Place Details, specificando solo l'ID luogo 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, se utilizzi 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 chiamata attiva Posiziona dettaglio nuovo (solo ID) oppure Dettagli luogo - Aggiornamento ID .

Questa richiesta potrebbe restituire anche lo stato NOT_FOUND le API nel tuo codice. Una strategia consiste nell'archiviare la richiesta originale che ha restituito ogni luogo ID. Se un ID luogo non è più valido, puoi emettere nuovamente la richiesta per che consentono di analizzare i dati e visualizzare i risultati. 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 ID luogo non valido. È possibile che INVALID_REQUEST venga 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 trasferisce in una nuova posizione. Gli ID dei luoghi possono cambiare a causa di aggiornamenti su larga scala Database Maps. In questi casi, un luogo potrebbe ricevere un nuovo ID luogo e il vecchio L'ID restituisce una risposta NOT_FOUND.

In particolare, alcuni tipi di ID luogo a volte possono causare un NOT_FOUND o l'API potrebbe restituire un ID luogo diverso in la risposta. Questi tipi di ID luogo includono:

  • Indirizzi che non esistono su Google Maps come indirizzi esatti ma sono dedotti da un intervallo di indirizzi.
  • Segmenti di un percorso lungo in cui la richiesta specifica anche una città o località.
  • Incroci.
  • Luoghi con un componente indirizzo di tipo subpremise.

Questi ID assumono spesso 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