Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Utilizzo degli ID dei luoghi
La ricerca di luoghi restituisce un elenco di risultati. La maggior parte dei risultati include un PlaceId corrispondente risultato. È possibile utilizzare PlaceId a in un'GetPlaceoperazione per restituire le informazioni su quel luogo (inclusi nome, indirizzo, posizione o altri dettagli).
Nota
SearchPlaceIndexForSuggestionsUsing restituirà PlaceId risultati per qualsiasi indice di luogo creato con qualsiasi fonte di dati. Usando SearchPlaceIndexForTextor SearchPlaceIndexForPositionrestituirà un PlaceId solo se l'origine dati utilizzata è HERE.
Ciascuno definisce PlaceId in modo univoco il luogo a cui si riferisce, ma un singolo luogo può averne più di uno PlaceId nel tempo e in base al contesto. Le seguenti regole descrivono l'unicità e la longevità di un. PlaceId
-
Le chiamate
PlaceIdrestituite che effettui sono specifiche per la tua Account AWS, per la AWS regione e per il fornitore di dati della tua risorsa.PlaceIndexGetPlacetroverà risultati solo quando questi tre attributi corrispondono alla chiamata originale che ha creato ilPlaceId. -
Il
PlaceIdnome di un luogo cambierà quando cambieranno i dati relativi a quel luogo. Ad esempio, quando l'azienda a cui si riferisce cambia sede o cambia nome. -
Il
PlaceIdrisultato di una chiamata di ricerca ripetuta può cambiare quando il servizio di backend effettua un aggiornamento. La versione precedentePlaceIdcontinuerà a essere trovata, ma le nuove chiamate alla ricerca potrebbero restituire un ID diverso.
PlaceIdÈ una stringa. Non esiste un limite specifico alla lunghezza di aPlaceId. Di seguito è riportato un esempio di validoPlaceId.
AQAAAIAADsn2T3KdrRWeaXLeVEyjNx_JfeTsMB0NVCEAnAZoJ-o3nqdlJZAdgcT2oWi1w9pS4wXXOk3O1vsKlGsPyHjV4EJxsu289i3hVO_BUPgP7SFoWAi8BW2v7LvAjQ5NfUPy7a1v9ajT3feIqcUZszWSTqKbJHFYvQqW7wdqhpQq3Wy-et39ZQDWSPLZUzgcjN-6VD2gyKkH0Po7gSm8YSJNSQ
La chiamata GetPlace con a PlaceId per un luogo i cui dati sono stati modificati (ad esempio, una sede aziendale che ha cessato l'attività), genererà un 404 ResourceNotFound errore. Una chiamata GetPlace con un PlaceId messaggio non valido o fuori contesto, ad esempio da un altro Account AWS, restituirà un 400 ValidationException errore.
Sebbene sia possibile utilizzare placeID nelle richieste successive, PlaceID non è destinato a essere un identificatore permanente e l'ID può cambiare tra chiamate API consecutive. Consulta il seguente comportamento di PlaceID per ogni fornitore di dati:
-
Esri: gli ID dei luoghi cambieranno almeno ogni trimestre. Il periodo di tempo tipico per queste modifiche sarebbe marzo, giugno, settembre e dicembre. Anche gli ID dei luoghi potrebbero cambiare tra le tipiche variazioni trimestrali, ma ciò sarà molto meno frequente.
-
QUI: Ti consigliamo di memorizzare i dati nella cache per non più di una settimana per mantenerli aggiornati. Si può supporre che vengano rilasciati meno dell'1% dei turni ID rispetto al rilascio, ovvero circa 1-2 volte a settimana.
-
Grab: I Place ID possono scadere o diventare non validi nelle seguenti situazioni.
Operazioni sui dati: il POI può essere rimosso dal database Grab POI da Grab Map Ops sulla base di criteri fondamentali, ad esempio se è chiuso nel mondo reale, viene rilevato come un POI duplicato o contiene informazioni errate. Grab sincronizzerà i dati con l'ambiente Waypoint su base settimanale.
POI interpolato: il POI interpolato è un POI temporaneo generato in tempo reale al momento dell'evasione di una richiesta e verrà contrassegnato come derivato nel campo della risposta.
place.result_typeLe informazioni sui POI interpolati verranno conservate per almeno 30 giorni, il che significa che entro 30 giorni potrai ottenere i dettagli dei POI tramite Place ID dall'API Place Details. Dopo 30 giorni, i POI interpolati (sia il Place ID che i dettagli) potrebbero scadere e diventare inaccessibili dall'API Places Details.
