Method: places.get

Dapatkan detail tempat berdasarkan nama resourcenya, yang merupakan string dalam format places/{placeId}.

Permintaan HTTP

GET https://places.googleapis.com/v1/{name=places/*}

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib. Nama resource tempat, dalam format places/{placeId}.

Parameter kueri

Parameter
languageCode

string

Opsional. Detail tempat akan ditampilkan dengan bahasa pilihan jika tersedia.

Daftar bahasa yang didukung saat ini: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

Opsional. Kode negara/wilayah Unicode (CLDR) lokasi tempat permintaan berasal. Parameter ini digunakan untuk menampilkan detail tempat, seperti nama tempat khusus wilayah, jika tersedia. Parameter ini dapat memengaruhi hasil berdasarkan hukum yang berlaku. Untuk mengetahui informasi selengkapnya, lihat https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Perhatikan bahwa kode wilayah 3 digit saat ini tidak didukung.
sessionToken

string

Opsional. String yang mengidentifikasi sesi Pelengkapan Otomatis untuk tujuan penagihan. Harus berupa string base64 yang aman untuk URL dan nama file dengan panjang maksimal 36 karakter ASCII. Jika tidak, error INVALID_ARGUMENT akan ditampilkan.

Sesi dimulai saat pengguna mulai mengetik kueri, dan berakhir saat mereka memilih tempat dan panggilan ke Place Details atau Address Validation dilakukan. Setiap sesi dapat memiliki beberapa kueri, yang diikuti dengan satu permintaan Place Details atau Address Validation. Kredensial yang digunakan untuk setiap permintaan dalam sesi harus berasal dari project Konsol Google Cloud yang sama. Setelah sesi selesai, token tidak lagi valid; aplikasi Anda harus membuat token baru untuk setiap sesi. Jika parameter sessionToken dihilangkan, atau jika Anda menggunakan kembali token sesi, sesi akan dikenai biaya seolah-olah tidak ada token sesi yang diberikan (setiap permintaan ditagih secara terpisah).

Sebaiknya ikuti panduan berikut:

  • Gunakan token sesi untuk semua panggilan Place Autocomplete.
  • Buat token baru untuk setiap sesi. Sebaiknya gunakan UUID versi 4.
  • Pastikan kredensial yang digunakan untuk semua permintaan Place Autocomplete, Place Details, dan Address Validation dalam sesi berasal dari project Konsol Cloud yang sama.
  • Pastikan untuk meneruskan token sesi yang unik untuk setiap sesi baru. Menggunakan token yang sama untuk lebih dari satu sesi akan menyebabkan setiap permintaan ditagih satu per satu.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat instance Place.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/maps-platform.places.details
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform