ID posizione

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.
Seleziona piattaforma: Android iOS JavaScript Servizio web

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 dell'API Geocoding e nel servizio Geocoding, API Maps JavaScript.
  • Specifica i punti di origine, di destinazione e intermedi nel servizio web dell'API Directions e nel servizio Directions, nell'API Maps JavaScript.
  • Specificare le origini e le destinazioni nel servizio web dell'API Distanza Matrice e nel servizio Matrice della distanza, nell'API Maps JavaScript.
  • Recupero dei dettagli dei luoghi nel servizio web dell'API Places, SDK Places per Android, SDK Places per iOS e libreria Places, API JavaScript.
  • Utilizzare i parametri dell'ID luogo nell'API Embed di Maps.
  • Recupero delle query di ricerca negli URL di Maps.
  • Visualizzazione dei limiti di velocità nell'API Roads.
  • Trovare e definire gli poligoni dei confini nello stile basato sui dati.

Trovare l'ID di un luogo specifico

Stai cercando l'ID di un luogo specifico? Usa la funzionalità di ricerca di ID luogo di seguito per cercare un luogo e ottenere il relativo ID:

In alternativa, puoi visualizzare la ricerca dell'ID luogo con il relativo codice nella documentazione dell'API Maps JavaScript.

Panoramica

L'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, tra cui attività commerciali, punti di riferimento, parchi e incroci. È possibile che allo stesso luogo o posizione siano associati più ID. Gli ID dei luoghi possono cambiare nel tempo.

Puoi usare lo stesso ID luogo nell'API Places e in varie API Google Maps Platform. Ad esempio, potete 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

Gli ID dei luoghi sono esenti dalle restrizioni di memorizzazione nella cache indicate nella Sezione 3.2.3(b) dei Termini di servizio di Google Maps Platform. Dopo aver identificato l'ID luogo di un luogo, puoi riutilizzarlo la prossima volta che cerchi quel luogo. Per maggiori informazioni, consulta la sezione Salvare gli ID luogo per un utilizzo futuro di seguito.

Un modo comune per utilizzare gli ID luogo è cercare un luogo (ad esempio, tramite l'API Places o la libreria Places nell'API Maps JavaScript), poi utilizzare l'ID luogo restituito per recuperare i dettagli del luogo. Puoi memorizzare l'ID luogo e utilizzarlo per recuperare gli stessi dettagli in un secondo momento. Scopri di più sul salvataggio degli ID luogo di seguito.

Esempio di utilizzo dell'API Places

Con l'API Places, puoi trovare un ID luogo effettuando una richiesta Place Search.

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, contenente 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"
}

Per una descrizione di tutti i campi della risposta, consulta la documentazione relativa a Ricerca di luoghi.

Ora puoi inviare una richiesta Dettagli luogo 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 luogo per un utilizzo futuro

Gli ID luogo sono esenti dalle limitazioni per la memorizzazione nella cache indicate nella Sezione 3.2.3(a) dei Termini di servizio di Google Maps Platform. Puoi quindi memorizzare i valori degli ID luogo per utilizzarli in un secondo momento.

Aggiornamento degli ID luogo archiviati in corso...

Consigliamo di aggiornare gli ID luogo se risalgono a più di 12 mesi prima. Puoi aggiornare gli ID luogo senza costi aggiuntivi effettuando una richiesta Dettagli luogo, specificando solo il campo place_id nel parametro fields. Questa operazione attiverà lo SKU Luoghi - ID aggiornamento SKU. Tuttavia, questa richiesta potrebbe restituire anche un codice di stato NOT_FOUND. Una strategia è archiviare la richiesta originale che ha restituito ciascun ID luogo. Se un ID luogo non è valido, puoi riemettere la richiesta per ottenere nuovi risultati. Questi risultati potrebbero includere o meno il luogo originale. La richiesta è addebitabile.

Codici di errore durante l'utilizzo degli ID luogo

Il codice di stato INVALID_REQUEST indica che l'ID luogo specificato non è valido. INVALID_REQUEST può essere restituito quando l'ID del luogo è stato troncato o altrimenti modificato e non è più corretto.

Il codice di stato NOT_FOUND indica che l'ID luogo specificato è obsoleto. L'ID di un luogo potrebbe diventare obsoleto se un'attività chiude o si trasferisce in una nuova sede. Gli ID dei luoghi possono 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 l'ID precedente restituisce una risposta NOT_FOUND.

In particolare, alcuni tipi di ID luogo potrebbero causare una risposta NOT_FOUND oppure l'API potrebbe restituire un ID luogo diverso nella risposta. Questi tipi di ID luogo includono:

  • Gli indirizzi stradali non esistono in Google Maps come indirizzi esatti, ma 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 sono spesso costituiti da 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