Memigrasikan respons Places API

Format respons untuk Place Details, Nearby Search, dan Text Search API baru telah berubah dari format API yang sudah ada. Perbedaan utamanya terletak pada format objek Place yang ditampilkan oleh setiap metode, seperti yang dijelaskan dalam Perubahan pada objek Tempat respons.

Selain itu, kolom tingkat atas dari objek respons juga telah berubah untuk setiap API. Lihat:

Perubahan pada objek Tempat respons

Tabel ini menampilkan perubahan pada objek Place baru dalam respons untuk Place Details (Baru), Nearby Search (Baru), dan Text Search (Baru) dibandingkan dengan objek Place yang sudah ada.

Objek respons baru menggunakan camel-casing untuk nama kolom, berisi kolom baru, dan mengganti nama beberapa kolom yang ada.

Kolom Objek Tempat yang Ada Objek Tempat baru Catatan
Komponen alamat address_components addressComponents
Alamat mikroformat 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 Tampilan geometry.viewport viewport
Atribusi tempat html_attributions attributions Kolom respons tingkat atas di API yang sudah ada
URL ikon icon Dihapus. Gunakan iconMaskBaseUri dan iconBackgroundColor. Lihat Ikon Tempat untuk 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 di objek Place yang baru. Untuk mengetahui informasi selengkapnya, lihat Mengubah ke 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 dari hari ini, dengan pengecualian dan semua data lainnya secondary_opening_hours currentSecondaryOpeningHours
Jenis tempat types types
URL Google Maps tempat url googleMapsUri
Jumlah rating pengguna user_ratings_total userRatingCount
Offset UTC utc_offset utcOffsetMinutes
Alamat dalam bentuk pendek, termasuk nama jalan dan kota vicinity shortFormattedAddress
Situs tempat website websiteUri
Informasi aksesibilitas kursi roda wheelchair_accessible_entrance accessibilityOptions wheelchair_accessible_entrance sekarang 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 Dalam API yang ada, kolom name berisi nama tempat sebagai string teks. Di API baru, informasi tersebut ada di displayName.
Jenis tempat utama primaryTypeName Baru
Menempatkan 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 tersebut paymentOptions Baru
Opsi parkir tempat parkingOptions Baru
Daftar sub-tujuan yang terkait dengan tempat subDestinations Baru
Informasi terbaru tentang opsi bahan bakar di SPBU fuelOptions Baru
Informasi SPKLU 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 dari objek respons untuk Text Search yang ada dan objek respons untuk Text Search (Baru). Untuk API baru, satu-satunya kolom tingkat teratas dalam respons adalah array places.

Kolom Text Search (Sudah Ada) 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 yang ada Array places dari objek Place baru
Status permintaan status Dipindahkan ke respons HTTP standar (pesan dan kode respons HTTP)
Pesan error apa pun error_message Dipindahkan ke respons HTTP standar (pesan dan kode 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 yang ada dan objek respons untuk Nearby Search (Baru). Untuk API baru, satu-satunya kolom tingkat teratas dalam respons adalah array places.

Kolom Nearby Search (Sudah Ada) 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 yang ada Array places untuk objek Place baru
Status permintaan status Dipindahkan ke respons HTTP standar (pesan dan kode respons HTTP)
Pesan error apa pun error_message Dipindahkan ke respons HTTP standar (pesan dan kode respons HTTP)
Pesan info apa pun info_messages Dihapus
Token halaman next_page_token Dihapus

Perubahan respons Place Details

Tabel berikut menunjukkan perubahan pada kolom tingkat teratas dari objek response untuk Place Details yang ada dan objek response untuk Place Details (Baru). Untuk API baru, satu-satunya kolom tingkat teratas dalam respons adalah array places.

Kolom Detail Tempat (Sudah Ada) Place Details (Baru) Catatan
Atribusi tempat html_attributions Dipindahkan ke objek Place baru sebagai attributions
Detail tempat result berisi objek Place yang ada Objek Place baru
Status permintaan status Dipindahkan ke respons HTTP standar (pesan dan kode respons HTTP)
Pesan info apa pun info_messages Dipindahkan ke respons HTTP standar (pesan dan kode respons HTTP)