Pengantar
Format respons untuk API
Place Details (Baru),
Nearby Search (Baru), dan
Text Search (Baru)
telah berubah dari format API lama. Perbedaan utamanya terletak pada
format objek Place yang ditampilkan oleh setiap metode, seperti yang dijelaskan dalam
Perubahan pada objek Place respons.
Selain itu, kolom tingkat atas objek respons juga telah berubah untuk setiap API. Lihat:
Perubahan pada objek Place respons
Tabel ini menunjukkan perubahan pada objek baru
Place
dalam respons untuk Place Details (Baru),
Nearby Search (Baru), dan
Text Search (Baru) dibandingkan dengan objek lama
Place.
Objek respons baru menggunakan camel case untuk nama kolom, berisi kolom baru, dan mengganti nama beberapa kolom lama.
| Kolom | Objek Places API (Lama) | Objek Places API (Baru) | Catatan |
|---|---|---|---|
| Komponen alamat | address_components |
addressComponents |
|
| Alamat microformat tempat | adr_address |
adrFormatAddress |
|
| Status bisnis | business_status |
businessStatus |
|
| Jam buka untuk minggu depan | current_opening_hours |
currentOpeningHours |
|
| Ringkasan editorial | editorial_summary |
editorialSummary |
|
| Alamat yang diformat | formatted_address |
formattedAddress |
|
| Nomor telepon nasional | formatted_phone_number |
nationalPhoneNumber |
|
| Lokasi | geometry.location |
location |
|
| Area Pandang | geometry.viewport |
viewport |
|
| Atribusi tempat | html_attributions |
attributions |
Kolom tingkat teratas respons di API lama |
| URL ikon | icon |
Dihapus. Gunakan iconMaskBaseUri dan
iconBackgroundColor. Lihat
Ikon tempat untuk
mengetahui informasi selengkapnya. |
|
| Warna latar belakang ikon | icon_background_color |
iconBackgroundColor |
|
| URL mask ikon | icon_mask_base_uri |
iconMaskBaseUri |
|
| Nomor telepon internasional | international_phone_number |
internationalPhoneNumber |
|
| Nama tempat teks | name |
displayName |
Nama tempat teks kini dapat diakses sebagai displayName.text dan
language sebagai displayName.languageCode |
| Jam buka | opening_hours |
regularOpeningHours |
|
| Foto | photos |
photos |
Format photos telah berubah dalam objek
Place baru. Untuk mengetahui informasi selengkapnya, lihat
Perubahan pada referensi foto. |
| ID tempat | place_id |
id |
|
| Plus Codes | plus_code |
plusCode |
|
| Tingkat harga | price_level |
priceLevel |
|
| Rating | rating |
rating |
|
| Ulasan | reviews |
reviews |
|
| Jam buka sekunder untuk minggu depan mulai hari ini, dengan pengecualian dan semua data lainnya | secondary_opening_hours |
currentSecondaryOpeningHours |
|
| Jenis tempat | types |
types |
|
| URL Google Maps tempat tersebut | url |
googleMapsUri |
|
| Jumlah rating pengguna | user_ratings_total |
userRatingCount |
|
| Selisih waktu UTC | utc_offset |
utcOffsetMinutes |
|
| Bentuk singkat alamat termasuk nama jalan dan kota | vicinity |
shortFormattedAddress |
|
| Situs tempat | website |
websiteUri |
|
| Informasi aksesibilitas kursi roda | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance kini berada di
accessibilityOptions.wheelchairAccessibleEntrance |
| Atribut tempat | takeout, delivery, dine_in, curbside_pickup, reservable,
serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine,
serves_brunch, serves_vegetarian_food |
takeout, delivery, dineIn, curbsidePickup, reservable,
servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine,
servesBrunch, servesVegetarianFood |
|
| Nama resource | Kolom name dalam formulir places/PLACE_ID |
Di API lama, kolom name berisi
nama tempat sebagai string teks. Di API baru, informasi tersebut ada di
displayName. |
|
| Jenis utama tempat | primaryTypeName |
Baru | |
| Tempatkan jenis utama sebagai string teks | primaryTypeDisplayName |
Baru | |
| Jam buka sekunder mingguan reguler, dengan pengecualian dan semua data lainnya | regularSecondaryOpeningHours |
Baru | |
| Opsi pembayaran yang diterima tempat ini | paymentOptions |
Baru | |
| Opsi tempat parkir | parkingOptions |
Baru | |
| Daftar sub-tujuan yang terkait dengan tempat | subDestinations |
Baru | |
| Informasi terbaru tentang opsi bahan bakar di SPBU | fuelOptions |
Baru | |
| Informasi pengisian daya kendaraan listrik untuk suatu tempat | evChargeOptions |
Baru | |
| Atribut tempat | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Baru |
Perubahan respons Text Search
Tabel berikut menunjukkan perubahan pada kolom tingkat teratas
objek respons
untuk Text Search (Lama) dan
objek respons
untuk Text Search (Baru). Untuk API baru, satu-satunya kolom tingkat teratas dalam respons adalah array places.
| Kolom | Text Search (Lama) | Text Search (Baru) | Catatan |
|---|---|---|---|
| Atribusi tempat | html_attributions |
Dipindahkan ke objek Place baru untuk setiap tempat sebagai place.attributions |
|
| Array tempat | Array results dari objek Place lama |
Array places dari objek Place baru |
|
| Status permintaan | status |
Dipindahkan ke respons HTTP standar (kode dan pesan respons HTTP) | |
| Pesan error apa pun | error_message |
Dipindahkan ke respons HTTP standar (kode dan pesan respons HTTP) | |
| Pesan info apa pun | info_messages |
Dihapus | |
| Token halaman | next_page_token |
Dihapus |
Perubahan respons Nearby Search
Tabel berikut menunjukkan perubahan pada kolom tingkat teratas objek respons untuk Nearby Search (Lama) dan objek respons untuk Nearby Search (Baru). Untuk API baru, satu-satunya kolom tingkat teratas dalam respons adalah array places.
| Kolom | Nearby Search (Lama) | Nearby Search (Baru) | Catatan |
|---|---|---|---|
| Atribusi tempat | html_attributions |
Dipindahkan ke objek Place
baru untuk setiap tempat sebagai place.attributions |
|
| Array tempat | Array results dari objek Place lama |
Array places dari objek
Place baru |
|
| Status permintaan | status |
Dipindahkan ke respons HTTP standar (kode dan pesan respons HTTP) | |
| Pesan error apa pun | error_message |
Dipindahkan ke respons HTTP standar (kode dan pesan respons HTTP) | |
| Pesan info apa pun | info_messages |
Dihapus | |
| Token halaman | next_page_token |
Dihapus |
Perubahan respons Place Details (Baru)
Tabel berikut menunjukkan perubahan pada kolom tingkat teratas objek response untuk Place Details (Lama) dan objek response untuk Place Details (Baru). Untuk API baru, satu-satunya kolom tingkat teratas dalam respons adalah array places.
| Kolom | Place Details (Legacy) | Place Details (Baru) | Catatan |
|---|---|---|---|
| Atribusi tempat | html_attributions |
Dipindahkan ke objek Place
baru sebagai attributions |
|
| Place Details (Baru) | result yang berisi objek Place lama |
Objek Place baru | |
| Status permintaan | status |
Dipindahkan ke respons HTTP standar (kode dan pesan respons HTTP) | |
| Pesan info apa pun | info_messages |
Dipindahkan ke respons HTTP standar (kode dan pesan respons HTTP) |