Menggunakan ID tempat

Mencari tempat mengembalikan daftar hasil. Sebagian besar hasil termasuk PlaceId untuk hasil itu. Anda dapat menggunakan a PlaceId dalam GetPlace operasi untuk mengembalikan informasi tentang tempat itu (termasuk nama, alamat, lokasi, atau detail lainnya).

catatan

Menggunakan SearchPlaceIndexForSuggestionsakan mengembalikan PlaceId hasil untuk indeks tempat mana pun yang dibuat dengan sumber data apa pun. Menggunakan SearchPlaceIndexForTextatau SearchPlaceIndexForPositionakan mengembalikan PlaceId hanya jika sumber data yang digunakan adalah DI SINI.

Masing-masing PlaceId secara unik mendefinisikan tempat yang dirujuknya, tetapi satu tempat dapat memiliki lebih dari satu dari waktu PlaceId ke waktu, dan berdasarkan konteksnya. Aturan berikut menggambarkan keunikan dan umur panjang a. PlaceId

• Panggilan yang PlaceId dikembalikan yang Anda lakukan khusus untuk Anda Akun AWS, ke AWS Wilayah, dan ke penyedia data di PlaceIndex sumber daya Anda. GetPlaceakan menemukan hasil hanya jika ketiga atribut ini cocok dengan panggilan asli yang membuatPlaceId.

• PlaceIdUntuk suatu tempat akan berubah ketika data tentang tempat itu berubah. Misalnya, ketika bisnis yang dirujuk pindah lokasi atau mengubah nama.

• PlaceIdPengembalian dari panggilan pencarian berulang dapat berubah ketika layanan backend membuat pembaruan. Yang lebih lama PlaceId akan terus ditemukan, tetapi panggilan baru untuk mencari dapat mengembalikan ID yang berbeda.

PlaceIdItu adalah string. Tidak ada batasan khusus untuk panjang aPlaceId. Berikut ini adalah contoh yang validPlaceId.

AQAAAIAADsn2T3KdrRWeaXLeVEyjNx_JfeTsMB0NVCEAnAZoJ-o3nqdlJZAdgcT2oWi1w9pS4wXXOk3O1vsKlGsPyHjV4EJxsu289i3hVO_BUPgP7SFoWAi8BW2v7LvAjQ5NfUPy7a1v9ajT3feIqcUZszWSTqKbJHFYvQqW7wdqhpQq3Wy-et39ZQDWSPLZUzgcjN-6VD2gyKkH0Po7gSm8YSJNSQ

Memanggil GetPlace dengan tempat yang datanya telah berubah (misalnya, lokasi bisnis yang telah keluar dari bisnis), akan menghasilkan ResourceNotFound kesalahan. PlaceId 404 Memanggil GetPlace dengan PlaceId yang tidak valid, atau salah satu di luar konteks, seperti dari yang lain Akun AWS, akan mengembalikan ValidationException kesalahan400,.

Meskipun Anda dapat menggunakan placeID dalam permintaan berikutnya, placeID tidak dimaksudkan sebagai pengenal permanen dan ID dapat berubah di antara panggilan API berturut-turut. Silakan lihat perilaku placeId berikut untuk setiap penyedia data:

• Esri: ID Place akan berubah setiap kuartal minimal. Periode waktu khas untuk perubahan ini adalah Maret, Juni, September, dan Desember. ID tempat juga dapat berubah antara perubahan triwulanan tipikal tetapi itu akan jauh lebih jarang.

• DI SINI: Kami menyarankan Anda menyimpan data tidak lebih dari seminggu untuk menjaga data Anda tetap segar. Anda dapat berasumsi bahwa kurang dari 1% pergeseran ID akan dirilis selama rilis yang kira-kira 1 - 2 kali per minggu.

• Grab: ID Place dapat kedaluwarsa atau menjadi tidak valid dalam situasi berikut.

  • Operasi data: POI dapat dihapus dari database POI Grab oleh Grab Map Ops berdasarkan kebenaran dasar, seperti ditutup di dunia nyata, terdeteksi sebagai POI duplikat, atau memiliki informasi yang salah. Grab akan menyinkronkan data ke lingkungan Waypoint setiap minggu.

  • POI interpolasi: POI interpolasi adalah POI sementara yang dihasilkan secara real time saat melayani permintaan, dan akan ditandai sebagai turunan di lapangan dalam respons. place.result_type Informasi POI yang diinterpolasi akan disimpan setidaknya selama 30 hari, yang berarti bahwa dalam 30 hari, Anda dapat memperoleh detail POI berdasarkan Place ID dari Place Details API. Setelah 30 hari, POI yang diinterpolasi (baik ID Tempat maupun detail) dapat kedaluwarsa dan tidak dapat diakses dari API Detail Tempat.