Questa pagina è stata tradotta dall'API Cloud Translation.

ID posizione

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 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 partenza intermedi, di destinazione e di destinazione 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 Distance Matrix e nel servizio Distance Matrix, API Maps JavaScript.
Recupero di Dettagli luogo nel servizio web dell'API Places, SDK Places per Android, SDK Places per iOS e Libreria Places, API JavaScript.
Utilizzo dei parametri Place ID nell'API Maps Embed.
Recupero delle query di ricerca negli URL di Maps.
Visualizzazione dei limiti di velocità nell'API Roads.
Ricerca e stile dei poligoni dei confini nello stile basato sui dati.

Avviso di ritiro: ID luoghi obsoleti

Trovare l'ID di un luogo specifico

Stai cercando l'ID luogo di un luogo specifico? Utilizza lo strumento di ricerca di ID luogo di seguito per cercare un luogo e ottenerne l'ID:

In alternativa, puoi visualizzare lo strumento di ricerca degli 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 per uno stesso luogo o una sede siano presenti più ID luogo. Gli ID dei luoghi possono cambiare nel tempo.

Puoi utilizzare lo stesso ID luogo nell'API Places e in varie API di 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 luogo sono esenti dalle limitazioni 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 riutilizzare tale valore la volta successiva che cerchi il luogo. Per scoprire di più, consulta la sezione Salvare gli ID luogo per utilizzarli in un secondo momento di seguito.

Un modo comune per utilizzare gli ID luogo è cercare un luogo (utilizzando, ad esempio, l'API Places o la libreria Places nell'API Maps JavaScript), quindi 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'SDK Places per iOS

L'ID luogo è un identificatore testuale che identifica in modo univoco un luogo. Nell'SDK Places per iOS, puoi recuperare l'ID di un luogo da un oggetto GMSPlace. Puoi archiviare l'ID luogo e utilizzarlo di nuovo per recuperare l'oggetto GMSPlace.

Per trovare un luogo tramite ID, chiama GMSPlacesClient fetchPlaceFromPlaceID:, trasmettendo i seguenti parametri:

Una stringa contenente un ID luogo.
Uno o più GMSPlaceField, specificando i tipi di dati da restituire.
Un token di sessione se la chiamata viene effettuata per concludere una query di completamento automatico. Altrimenti, passa nil.
Un elemento GMSPlaceResultCallback per gestire il risultato.

L'API richiama il metodo di callback specificato, trasmettendo un oggetto GMSPlace. Se il luogo non viene trovato, l'oggetto luogo è null.

Swift

// A hotel in Saigon with an attribution.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"

// Specify the place data types to return.
let fields: GMSPlaceField = GMSPlaceField(rawValue: UInt(GMSPlaceField.name.rawValue) |
  UInt(GMSPlaceField.placeID.rawValue))!

placesClient?.fetchPlace(fromPlaceID: placeID, placeFields: fields, sessionToken: nil, callback: {
  (place: GMSPlace?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }
  if let place = place {
    self.lblName?.text = place.name
    print("The selected place is: \(place.name)")
  }
})

Objective-C

// A hotel in Saigon with an attribution.
NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

// Specify the place data types to return.
GMSPlaceField fields = (GMSPlaceFieldName | GMSPlaceFieldPlaceID);

[_placesClient fetchPlaceFromPlaceID:placeID placeFields:fields sessionToken:nil callback:^(GMSPlace * _Nullable place, NSError * _Nullable error) {
  if (error != nil) {
    NSLog(@"An error occurred %@", [error localizedDescription]);
    return;
  }
  if (place != nil) {
    NSLog(@"The selected place is: %@", [place name]);
  }
}];

Salva gli ID luogo per utilizzarli in un secondo momento

Gli ID luogo sono esenti dalle limitazioni di 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 dei luoghi archiviati

Consigliamo di aggiornare gli ID luogo se hanno più di 12 mesi. Per aggiornare gli ID luogo, senza costi, effettua una richiesta Dettagli luogo, specificando solo il campo GMSPlaceFieldPlaceID nel parametro fields. Questa chiamata attiverà lo SKU Dettagli luogo - aggiornamento dell'ID SKU. Tuttavia, questa richiesta potrebbe anche restituire il codice di stato NOT_FOUND. Una strategia consiste nell'archiviare la richiesta originale che ha restituito ciascun ID del luogo. Se un ID luogo non è più valido, puoi riemettere tale richiesta per ottenere nuovi risultati. Questi risultati potrebbero includere o meno il luogo originale. La richiesta è addebitabile.

Nota: per i primi giorni dopo che un ID luogo non è più valido, questa strategia potrebbe comunque generare NOT_FOUND quando la richiesta originale utilizzata è una richiesta di completamento automatico di un luogo o una query.

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 potrebbe essere restituito dopo che l'ID 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 luogo può 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 il vecchio ID restituisce una risposta NOT_FOUND.

In particolare, alcuni tipi di ID luogo potrebbero causare una risposta NOT_FOUND o 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 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 assumono spesso la forma di una stringa lunga (non è prevista 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