Memigrasikan respons Places API

Format respons untuk model Place Details, Nearby Search, dan Penelusuran Teks API 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 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 Place baru dalam respons untuk Place Details (Baru), Nearby Search (Baru), dan Text Search (Baru) dibandingkan dengan objek Place yang ada.

Objek respons baru menggunakan camel-casing untuk nama kolom, berisi kolom baru, dan mengganti nama beberapa {i>field<i} 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 Pandang geometry.viewport viewport
Atribusi tempat html_attributions attributions Kolom tingkat atas respons di API yang ada
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 di versi baru Objek Place. Untuk informasi selengkapnya, lihat Ubah 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 bentuk places/PLACE_ID Di API yang ada, kolom name berisi nama tempat sebagai string teks. Di API baru, informasi tersebut displayName.
Jenis utama tempat primaryTypeName Baru
Menempatkan jenis utama sebagai string teks primaryTypeDisplayName Baru
Jam buka sekunder mingguan reguler, dengan pengecualian dan semua jam buka lainnya data regularSecondaryOpeningHours Baru
Opsi pembayaran yang diterima tempat 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 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 (Existing) 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 (kode dan pesan 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 respons respons objek untuk Nearby Search yang ada dan respons objek untuk Nearby Search (Baru). Untuk API baru, satu-satunya bidang tingkat teratas di responsnya 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 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 (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 objek respons untuk Place Details yang ada dan objek respons untuk Place Details (Baru). Untuk API baru, satu-satunya kolom tingkat teratas dalam respons adalah array places.

Kolom Place Details (Existing) Place Details (Baru) Catatan
Atribusi tempat html_attributions Pindah ke Tempat baru objek sebagai attributions
Detail tempat result yang 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 (kode dan pesan respons HTTP)