Setelah memiliki ID tempat, Anda dapat meminta detail selengkapnya tentang tempat usaha atau tempat menarik tertentu dengan memulai permintaan Place Details (New). Permintaan Place Details (Baru) menampilkan informasi yang lebih komprehensif tentang tempat yang ditunjukkan seperti alamat lengkap, nomor telepon, peringkat pengguna, dan ulasan.
Ada banyak cara untuk mendapatkan ID tempat. Anda dapat menggunakan:
- Text Search (Baru) atau Nearby Search (Baru)
- Geocoding API
- Routes API
- Address Validation API
- Pelengkapan Otomatis Tempat
API Explorer memungkinkan Anda membuat permintaan langsung sehingga Anda dapat memahami API dan opsi API:
Cobalah!Permintaan Place Details (Baru)
Permintaan Place Details adalah permintaan HTTP GET dalam bentuk:
https://places.googleapis.com/v1/places/PLACE_ID
Teruskan semua parameter sebagai parameter URL atau di header sebagai bagian dari permintaan GET. Contoh:
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY
Atau di perintah cURL:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Respons Place Details (Baru)
Place Details (Baru) menampilkan objek JSON sebagai respons. Dalam respons:
- Respons direpresentasikan oleh objek
Place
. ObjekPlace
berisi informasi mendetail tentang tempat. - FieldMask yang diteruskan dalam permintaan menentukan daftar kolom
yang ditampilkan dalam objek
Place
.
Objek JSON lengkap tersedia dalam bentuk:
{ "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g", "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g", "displayName": { "text": "Trinidad" } ... }
Parameter wajib
-
FieldMask
Tentukan daftar kolom yang akan ditampilkan dalam respons dengan membuat mask kolom respons. Teruskan mask kolom respons ke metode menggunakan parameter URL
$fields
ataufields
, atau dengan menggunakan header HTTPX-Goog-FieldMask
. Tidak ada daftar default kolom yang ditampilkan dalam respons. Jika Anda menghilangkan mask kolom, metode akan menampilkan error.Penyamaran kolom merupakan praktik desain yang baik untuk memastikan Anda tidak meminta data yang tidak diperlukan. Cara ini akan membantu Anda menghindari waktu pemrosesan dan biaya penagihan yang tidak perlu.
Tentukan daftar jenis data tempat yang dipisahkan koma yang akan ditampilkan. Misalnya, untuk mengambil nama tampilan dan alamat tempat.
X-Goog-FieldMask: displayName,formattedAddress
Gunakan
*
untuk mengambil semua kolom.X-Goog-FieldMask: *
Tentukan satu atau beberapa kolom berikut:
Kolom berikut memicu SKU Place Details (IDs Only):
attributions
,id
,name
*,photos
* Kolomname
berisi nama resource tempat dalam bentuk:places/PLACE_ID
. GunakandisplayName
untuk mengakses nama tekstual tempat tersebut.Kolom berikut memicu SKU Place Details (Location Only):
addressComponents
,adrFormatAddress
,formattedAddress
,location
,plusCode
,shortFormattedAddress
,types
,viewport
Kolom berikut memicu SKU Place Details (Basic):
accessibilityOptions
,businessStatus
,containingPlaces
,displayName
,googleMapsLinks
*,googleMapsUri
,iconBackgroundColor
,iconMaskBaseUri
,primaryType
,primaryTypeDisplayName
,pureServiceAreaBusiness
,subDestinations
,utcOffsetMinutes
* KolomgoogleMapsLinks
berada dalam tahap Pratinjau pra-GA dan tidak ada biaya, yang berarti penagihan adalah $0, untuk penggunaan selama Pratinjau.Kolom berikut memicu SKU Place Details (Advanced):
currentOpeningHours
,currentSecondaryOpeningHours
,internationalPhoneNumber
,nationalPhoneNumber
,priceLevel
,priceRange
,rating
,regularOpeningHours
,regularSecondaryOpeningHours
,userRatingCount
,websiteUri
Kolom berikut memicu SKU Place Details (Preferred):
allowsDogs
,curbsidePickup
,delivery
,dineIn
,editorialSummary
,evChargeOptions
,fuelOptions
,goodForChildren
,goodForGroups
,goodForWatchingSports
,liveMusic
,menuForChildren
,parkingOptions
,paymentOptions
,outdoorSeating
,reservable
,restroom
,reviews
,routingSummaries
,*servesBeer
,servesBreakfast
,servesBrunch
,servesCocktails
,servesCoffee
,servesDessert
,servesDinner
,servesLunch
,servesVegetarianFood
,servesWine
,takeout
* Penelusuran Teks dan Penelusuran Langsung saja
-
placeId
ID tekstual yang secara unik mengidentifikasi tempat, yang ditampilkan dari Text Search (New) atau Nearby Search (New). Untuk informasi selengkapnya tentang ID tempat, lihat ringkasan ID tempat.
String
places/PLACE_ID
juga disebut dengan nama resource tempat. Sebagai respons dari permintaan Place Details (Baru), Nearby Search (Baru), dan Text Search (Baru), string ini dimuat dalam kolomname
respons. ID tempat mandiri terdapat di kolomid
pada respons.
Parameter opsional
languageCode
Bahasa yang digunakan untuk menampilkan hasil.
- Lihat daftar bahasa yang didukung. Google sering memperbarui bahasa yang didukung, sehingga daftar ini mungkin tidak lengkap.
-
Jika
languageCode
tidak diberikan, API akan ditetapkan secara default keen
. Jika Anda menentukan kode bahasa yang tidak valid, API akan menampilkan errorINVALID_ARGUMENT
. - API akan melakukan yang terbaik untuk menyediakan alamat yang bisa dibaca oleh pengguna dan penduduk setempat. Untuk mencapai tujuan tersebut, metode ini menampilkan alamat dalam bahasa lokal, yang ditransliterasi ke skrip yang dapat dibaca oleh pengguna jika perlu, dengan memperhatikan bahasa pilihan. Semua alamat lainnya akan ditampilkan dalam bahasa pilihan. Semua komponen alamat dikembalikan dalam bahasa yang sama, yang dipilih dari komponen pertama.
- Jika nama tidak tersedia dalam bahasa yang dipilih, API akan menggunakan kecocokan terdekat.
- Bahasa yang dipilih berpengaruh kecil terhadap serangkaian hasil yang dipilih API untuk ditampilkan, dan urutan pengembaliannya. Geocoder menafsirkan singkatan secara berbeda bergantung pada bahasa, seperti singkatan untuk jenis jalan, atau sinonim yang mungkin valid dalam satu bahasa, tetapi tidak dalam bahasa lain.
regionCode
Kode wilayah yang digunakan untuk memformat respons, ditetapkan sebagai nilai kode CLDR dua karakter. Tidak ada nilai default.
Jika nama negara kolom
formattedAddress
dalam respons cocok denganregionCode
, kode negara akan dihilangkan dariformattedAddress
. Parameter ini tidak berpengaruh padaadrFormatAddress
, yang selalu menyertakan nama negara, atau padashortFormattedAddress
, yang tidak pernah menyertakannya.Sebagian besar kode CLDR identik dengan kode ISO 3166-1, dengan beberapa pengecualian. Misalnya, ccTLD Inggris Raya adalah "uk" (.co.uk) sedangkan kode ISO 3166-1-nya adalah "gb" (secara teknis untuk entitas "The United Kingdom of Great Britain and Northern Ireland"). Parameter ini dapat memengaruhi hasil berdasarkan hukum yang berlaku.
-
sessionToken
Token sesi adalah string buatan pengguna yang melacak panggilan Autocomplete (Baru) sebagai "sesi". Autocomplete (Baru) menggunakan token sesi untuk mengelompokkan fase kueri dan pemilihan tempat dari penelusuran pelengkapan otomatis pengguna ke dalam sesi terpisah untuk tujuan penagihan. Token sesi diteruskan ke panggilan Place Details (Baru) yang mengikuti panggilan Autocomplete (Baru). Untuk mengetahui informasi selengkapnya, lihat Token sesi.
Contoh Place Details
Contoh berikut meminta detail tempat berdasarkan placeId
:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Perhatikan bahwa header X-Goog-FieldMask
menetapkan bahwa
respons
berisi kolom data berikut: id,displayName
.
Responsnya kemudian dalam bentuk:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "displayName": { "text": "Googleplex", "languageCode": "en" } }
Tambahkan lebih banyak jenis data ke mask kolom untuk menampilkan informasi tambahan.
Misalnya, tambahkan formattedAddress,plusCode
untuk menyertakan
alamat dan Plus Code dalam
respons:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Responsnya kini berbentuk:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "plusCode": { "globalCode": "849VCWC7+RW", "compoundCode": "CWC7+RW Mountain View, CA, USA" }, "displayName": { "text": "Googleplex", "languageCode": "en" } }
Cobalah!
API Explorer memungkinkan Anda membuat contoh permintaan sehingga Anda dapat memahami API dan opsi API.
Untuk membuat permintaan:
- Pilih ikon API, , di sisi kanan halaman.
- (Opsional) Tetapkan parameter
name
ke:places/PLACE_ID
- Jika ingin, luaskan Show standard parameters dan tetapkan
parameter
fields
ke field mask. - Pilih tombol Execute. Di pop-up, pilih akun yang ingin Anda gunakan untuk membuat permintaan.
Di panel API Explorer, pilih ikon luaskan, , untuk meluaskan jendela API Explorer.