Setelah memiliki place_id dari penelusuran tempat, Anda dapat
meminta detail selengkapnya tentang tempat usaha atau
lokasi menarik tertentu dengan memulai permintaan Place Details (Lama). Permintaan Place Details (Lama)
menampilkan informasi yang lebih komprehensif tentang tempat yang ditunjukkan,
seperti alamat lengkap, nomor telepon, rating pengguna, dan ulasan pengguna.
Permintaan Place Details (Lama)
Permintaan Place Details (Lama) adalah URL HTTP dengan format berikut:
https://maps.googleapis.com/maps/api/place/details/output?parameters
dengan output dapat berupa salah satu dari nilai berikut:
json(direkomendasikan) menunjukkan output dalam JavaScript Object Notation (JSON)xmlmenunjukkan output sebagai XML
Diperlukan parameter tertentu untuk memulai permintaan penelusuran. Sesuai dengan standar dalam URL, semua parameter dipisah menggunakan karakter ampersand (&). Bagian berikut mencantumkan parameter dan
kemungkinan nilainya.
Parameter yang diperlukan
-
place_id
ID tekstual yang secara unik mengidentifikasi tempat, yang ditampilkan dari Place Search (Lama). Untuk informasi selengkapnya tentang ID tempat, lihat ringkasan ID tempat.
Parameter opsional
-
Fields
Perhatian: Permintaan Place Search (Lama) dan permintaan Place Details (Lama) tidak menampilkan kolom yang sama. Permintaan Place Search (Lama) menampilkan sub-kumpulan kolom yang ditampilkan berdasarkan permintaan Place Details (Lama). Jika kolom yang Anda inginkan tidak ditampilkan oleh Place Search (Lama), Anda dapat menggunakan Place Search (Lama) untuk mendapatkanplace_id, lalu menggunakan ID Tempat tersebut untuk membuat permintaan Place Details (Lama). Untuk mengetahui informasi selengkapnya tentang kolom yang tidak tersedia dalam permintaan Place Search (Lama), lihat Kolom Data Tempat (Lama).Gunakan parameter fields untuk menentukan daftar jenis data tempat yang dipisahkan koma untuk ditampilkan. Contoh:
fields=formatted_address,name,geometry. Gunakan garis miring saat menentukan nilai gabungan. Contoh:opening_hours/open_now.Kolom dibagi menjadi tiga kategori penagihan: Basic, Contact, dan Atmosphere. SKU Basic, Contact, dan Atmosphere dikenai biaya selain SKU dasar (Places Details, Find Place, Nearby Search, atau Text Search) untuk permintaan yang memicunya. Untuk mengetahui informasi selengkapnya, lihat sheet harga.
Basic
Kategori Basic mencakup kolom berikut:
address_components,adr_address,business_status,formatted_address,geometry,icon,icon_mask_base_uri,icon_background_color,name,permanently_closed(tidak digunakan lagi),photo,place_id,plus_code,type,url,utc_offset,vicinity,wheelchair_accessible_entrance.Kontak
Kategori Contact mencakup kolom berikut:
current_opening_hours,formatted_phone_number,international_phone_number,opening_hours,secondary_opening_hours,websiteAtmosphere
Kategori Atmosphere mencakup kolom berikut:
curbside_pickup,delivery,dine_in,editorial_summary,price_level,rating,reservable,reviews,serves_beer,serves_breakfast,serves_brunch,serves_dinner,serves_lunch,serves_vegetarian_food,serves_wine,takeout,user_ratings_total.Catatan: Atribusi,html_attributions, selalu ditampilkan dengan setiap panggilan, terlepas dari apakah kolom telah diminta atau tidak. -
bahasa
Bahasa yang digunakan untuk menampilkan hasil.
- Lihat daftar bahasa yang didukung. Google sering memperbarui bahasa yang didukung, sehingga daftar ini mungkin tidak lengkap.
-
Jika
languagetidak diberikan, API akan mencoba menggunakan bahasa pilihan seperti yang ditentukan di headerAccept-Language. - API ini berupaya sebaik mungkin untuk memberikan alamat yang dapat dibaca oleh pengguna dan penduduk setempat. Untuk mencapai tujuan tersebut, API ini menampilkan alamat jalan dalam bahasa lokal, yang ditransliterasikan ke skrip yang dapat dibaca oleh pengguna jika perlu, dengan mengamati bahasa pilihan. Semua alamat lainnya ditampilkan dalam bahasa pilihan. Komponen alamat semuanya ditampilkan dalam bahasa yang sama, yang dipilih dari komponen pertama.
- Jika nama tidak tersedia dalam bahasa pilihan, API akan menggunakan kecocokan terdekat.
- Bahasa pilihan memiliki pengaruh kecil pada kumpulan hasil yang dipilih API untuk ditampilkan, dan urutan kemunculannya. 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. Misalnya, utca dan tér adalah sinonim untuk jalan dalam bahasa Hungaria.
-
region
Kode wilayah, yang ditetapkan sebagai nilai dua karakter ccTLD ("domain level teratas"). Sebagian besar kode ccTLD 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").
-
reviews_no_translations
Tentukan
reviews_no_translations=trueuntuk menonaktifkan terjemahan ulasan; tentukanreviews_no_translations=falseuntuk mengaktifkan terjemahan ulasan. Ulasan ditampilkan dalam bahasa aslinya.Jika dihilangkan, atau diteruskan tanpa nilai, terjemahan ulasan akan diaktifkan. Jika parameter
languageditentukan dalam permintaan, gunakan bahasa yang ditentukan sebagai bahasa pilihan untuk terjemahan. Jikalanguagedihilangkan, API akan mencoba menggunakan headerAccept-Languagesebagai bahasa pilihan. -
reviews_sort
Metode pengurutan yang akan digunakan saat menampilkan ulasan. Dapat ditetapkan ke
most_relevant(default) ataunewest.-
Untuk
most_relevant(default), ulasan diurutkan berdasarkan relevansi; layanan akan membiaskan hasil untuk menampilkan ulasan yang awalnya ditulis dalam bahasa pilihan. -
Untuk
newest, ulasan diurutkan dalam urutan kronologis; bahasa pilihan tidak memengaruhi tata urutan.
Google merekomendasikan agar Anda menampilkan cara ulasan diurutkan kepada pengguna akhir.
-
Untuk
-
sessiontoken
String acak yang mengidentifikasi sesi pelengkapan otomatis untuk tujuan penagihan.
Sesi dimulai saat pengguna mulai mengetik kueri, dan berakhir saat pengguna memilih tempat dan panggilan ke Place Details (Lama) dilakukan. Setiap sesi dapat memiliki beberapa kueri, yang diikuti dengan satu pilihan tempat. Kunci API yang digunakan untuk setiap permintaan dalam satu 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
sessiontokendihilangkan, atau jika Anda menggunakan kembali token sesi, sesi tersebut dikenai biaya seolah-olah tidak ada token sesi yang diberikan (setiap permintaan ditagih secara terpisah).Sebaiknya ikuti panduan berikut:
- Gunakan token sesi untuk semua sesi pelengkapan otomatis.
- Buat token baru untuk setiap sesi. Sebaiknya gunakan UUID versi 4.
- Pastikan kunci API yang digunakan untuk semua permintaan Place Autocomplete dan Place Details dalam satu sesi berasal dari project Konsol Cloud yang sama.
- Pastikan untuk meneruskan token sesi yang unik untuk setiap sesi baru. Jika menggunakan token yang sama untuk lebih dari satu sesi, setiap permintaan akan ditagih satu per satu.
Contoh Place Details (Lama)
Contoh berikut meminta detail tempat berdasarkan
place_id, dan menyertakan kolom name, rating,
dan formatted_phone_number:
Shell
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating%2Cformatted_phone_number&key=YOUR_API_KEY'
HTTP
https://maps.googleapis.com/maps/api/place/details/json ?fields=name%2Crating%2Cformatted_phone_number &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4 &key=YOUR_API_KEY
Ganti kunci dalam contoh ini dengan kunci API Anda sendiri agar permintaan berfungsi di aplikasi Anda.
Respons Place Details (Lama)
Respons Place Details (Lama) ditampilkan dalam format yang ditunjukkan oleh flag output dalam jalur URL permintaan.
JSON
{ "html_attributions": [], "result": { "address_components": [ { "long_name": "48", "short_name": "48", "types": ["street_number"] }, { "long_name": "Pirrama Road", "short_name": "Pirrama Rd", "types": ["route"], }, { "long_name": "Pyrmont", "short_name": "Pyrmont", "types": ["locality", "political"], }, { "long_name": "City of Sydney", "short_name": "City of Sydney", "types": ["administrative_area_level_2", "political"], }, { "long_name": "New South Wales", "short_name": "NSW", "types": ["administrative_area_level_1", "political"], }, { "long_name": "Australia", "short_name": "AU", "types": ["country", "political"], }, { "long_name": "2009", "short_name": "2009", "types": ["postal_code"], }, ], "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia", "business_status": "OPERATIONAL", "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia", "formatted_phone_number": "(02) 9374 4000", "geometry": { "location": { "lat": -33.866489, "lng": 151.1958561 }, "viewport": { "northeast": { "lat": -33.8655112697085, "lng": 151.1971156302915 }, "southwest": { "lat": -33.86820923029149, "lng": 151.1944176697085 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png", "icon_background_color": "#7B9EB0", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "international_phone_number": "+61 2 9374 4000", "name": "Google Workplace 6", "opening_hours": { "open_now": false, "periods": [ { "close": { "day": 1, "time": "1700" }, "open": { "day": 1, "time": "0900" }, }, { "close": { "day": 2, "time": "1700" }, "open": { "day": 2, "time": "0900" }, }, { "close": { "day": 3, "time": "1700" }, "open": { "day": 3, "time": "0900" }, }, { "close": { "day": 4, "time": "1700" }, "open": { "day": 4, "time": "0900" }, }, { "close": { "day": 5, "time": "1700" }, "open": { "day": 5, "time": "0900" }, }, ], "weekday_text": [ "Monday: 9:00 AM – 5:00 PM", "Tuesday: 9:00 AM – 5:00 PM", "Wednesday: 9:00 AM – 5:00 PM", "Thursday: 9:00 AM – 5:00 PM", "Friday: 9:00 AM – 5:00 PM", "Saturday: Closed", "Sunday: Closed", ], }, "photos": [ { "height": 3024, "html_attributions": [ "Cynthia Wei", ], "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX", "width": 4032, }, { "height": 3264, "html_attributions": [ "Heyang Li", ], "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI", "width": 4912, }, // ... ], "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4", "plus_code": { "compound_code": "45MW+C8 Pyrmont NSW, Australia", "global_code": "4RRH45MW+C8", }, "rating": 4, "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4", "reviews": [ { "author_name": "Luke Archibald", "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "a week ago", "text": "Beautiful building with a great view.", "time": 1652286798, }, { "author_name": "Tevita Taufoou", "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "6 months ago", "text": "Conference rooms were well equipped.", "time": 1637215605, }, // ... ], "types": ["point_of_interest", "establishment"], "url": "https://maps.google.com/?cid=10281119596374313554", "user_ratings_total": 939, "utc_offset": 600, "vicinity": "48 Pirrama Road, Pyrmont", "website": "http://google.com/", }, "status": "OK", }
XML
<?xml version="1.0" encoding="UTF-8"?> <PlaceDetailsResponse> <status>OK</status> <result> <name>Google Workplace 6</name> <vicinity>48 Pirrama Road, Pyrmont</vicinity> <type>point_of_interest</type> <type>establishment</type> <formatted_phone_number>(02) 9374 4000</formatted_phone_number> <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, Australia</formatted_address> <address_component> <long_name>48</long_name> <short_name>48</short_name> <type>street_number</type> </address_component> <address_component> <long_name>Pirrama Road</long_name> <short_name>Pirrama Rd</short_name> <type>route</type> </address_component> <address_component> <long_name>Pyrmont</long_name> <short_name>Pyrmont</short_name> <type>locality</type> <type>political</type> </address_component> <address_component> <long_name>City of Sydney</long_name> <short_name>City of Sydney</short_name> <type>administrative_area_level_2</type> <type>political</type> </address_component> <address_component> <long_name>New South Wales</long_name> <short_name>NSW</short_name> <type>administrative_area_level_1</type> <type>political</type> </address_component> <address_component> <long_name>Australia</long_name> <short_name>AU</short_name> <type>country</type> <type>political</type> </address_component> <address_component> <long_name>2009</long_name> <short_name>2009</short_name> <type>postal_code</type> </address_component> <geometry> <location> <lat>-33.8664890</lat> <lng>151.1958561</lng> </location> <viewport> <southwest> <lat>-33.8682092</lat> <lng>151.1944177</lng> </southwest> <northeast> <lat>-33.8655113</lat> <lng>151.1971156</lng> </northeast> </viewport> </geometry> <rating>4.0</rating> <url>https://maps.google.com/?cid=10281119596374313554</url> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference> <international_phone_number>+61 2 9374 4000</international_phone_number> <website>http://google.com/</website> <review> <time>1652286798</time> <text>Beautiful building with a great view.</text> <author_name>Luke Archibald</author_name> <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>a week ago</relative_time_description> </review> <review> <time>1637215605</time> <text>Conference rooms were well equipped.</text> <author_name>Joe Schmoe</author_name> <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>6 months ago</relative_time_description> </review> <!-- ... --> <opening_hours> <open_now>false</open_now> <period> <open> <day>1</day> <time>0900</time> </open> <close> <day>1</day> <time>1700</time> </close> </period> <period> <open> <day>2</day> <time>0900</time> </open> <close> <day>2</day> <time>1700</time> </close> </period> <period> <open> <day>3</day> <time>0900</time> </open> <close> <day>3</day> <time>1700</time> </close> </period> <period> <open> <day>4</day> <time>0900</time> </open> <close> <day>4</day> <time>1700</time> </close> </period> <period> <open> <day>5</day> <time>0900</time> </open> <close> <day>5</day> <time>1700</time> </close> </period> <weekday_text>Monday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Tuesday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Wednesday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Thursday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Friday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Saturday: Closed</weekday_text> <weekday_text>Sunday: Closed</weekday_text> </opening_hours> <utc_offset>600</utc_offset> <photo> <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/117600448889234589608">Cynthia Wei</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference> <width>4912</width> <height>3264</height> <html_attribution><a href="https://maps.google.com/maps/contrib/102493344958625549078">Heyang Li</a></html_attribution> </photo> <!-- ... --> <adr_address><span class="street-address">48 Pirrama Rd</span>, <span class="locality">Pyrmont</span> <span class="region">NSW</span> <span class="postal-code">2009</span>, <span class="country-name">Australia</span></adr_address> <user_ratings_total>939</user_ratings_total> <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id> <plus_code> <global_code>4RRH45MW+C8</global_code> <compound_code>45MW+C8 Pyrmont NSW, Australia</compound_code> </plus_code> <icon_background_color>#7B9EB0</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri> </result> </PlaceDetailsResponse>
Respons JSON dan XML masing-masing berisi elemen berikut:
PlacesDetailsResponse
| Kolom | Wajib | Jenis | Deskripsi |
|---|---|---|---|
|
required | Array<string> |
Dapat berisi kumpulan atribusi tentang listingan ini yang harus ditampilkan kepada pengguna (beberapa listingan mungkin tidak memiliki atribusi). |
|
required | Tempat |
Berisi informasi mendetail tentang tempat yang diminta. Lihat Tempat untuk mengetahui informasi selengkapnya. |
|
required | PlacesDetailsStatus |
Berisi status permintaan, dan mungkin berisi informasi proses debug untuk membantu Anda melacak penyebab kegagalan permintaan. Lihat PlacesDetailsStatus untuk mengetahui informasi selengkapnya. |
|
opsional | Array<string> |
Jika layanan menampilkan informasi tambahan tentang spesifikasi permintaan, mungkin ada kolom |
Dalam respons JSON, elemen ini direpresentasikan sebagai elemen root. Dalam respons XML, elemen ini muncul sebagai elemen tingkat atas di bawah <PlaceDetailsResponse>.
PlacesDetailsStatus
Kode status yang ditampilkan oleh layanan.
OKyang menunjukkan bahwa permintaan API berhasil.-
ZERO_RESULTSyang menunjukkan bahwa lokasi yang dirujuk,place_id, valid, tetapi tidak lagi merujuk ke hasil yang valid. Hal ini dapat terjadi jika tempat usaha itu tidak lagi beroperasi. -
NOT_FOUNDyang menunjukkan bahwa lokasi yang dirujuk,place_id, tidak ditemukan dalam database Places. -
INVALID_REQUESTyang menunjukkan bahwa permintaan API memiliki format yang salah. -
OVER_QUERY_LIMITyang menunjukkan salah satu hal berikut:- Anda telah melampaui batas QPS.
- Penagihan belum diaktifkan di akun Anda.
- Kredit bulanan sebesar $200, atau batas penggunaan yang ditentukan sendiri, telah terlampaui.
- Metode pembayaran yang diberikan sudah tidak valid (misalnya kartu kredit yang sudah tidak berlaku).
-
REQUEST_DENIEDyang menunjukkan bahwa permintaan Anda ditolak, biasanya karena:- Permintaan tidak memiliki kunci API.
- Parameter
keytidak valid.
UNKNOWN_ERRORmenunjukkan error yang tidak dikenal.
Tempat
Atribut yang mendeskripsikan tempat. Tidak semua atribut akan tersedia untuk semua jenis tempat.
| Kolom | Wajib | Jenis | Deskripsi |
|---|---|---|---|
|
opsional |
Array<AddressComponent>
|
Array yang berisi komponen terpisah yang berlaku untuk alamat ini.
Lihat |
|
opsional | string |
Representasi alamat tempat dalam mikroformat adr. |
|
opsional | string |
Menunjukkan status operasional tempat, jika berupa bisnis.
Jika tidak ada data,
The allowed values include:
OPERATIONAL,
CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
|
|
opsional | boolean |
Menentukan apakah bisnis mendukung Ambil di luar toko. |
|
opsional | PlaceOpeningHours |
Berisi jam buka untuk tujuh hari ke depan (termasuk hari ini). Jangka waktu dimulai pada tengah malam pada tanggal
permintaan dan berakhir pada pukul 23.59 enam hari kemudian. Kolom ini mencakup subkolom Lihat PlaceOpeningHours untuk mengetahui informasi selengkapnya. |
|
opsional | boolean |
Menentukan apakah bisnis mendukung pengiriman. |
|
opsional | boolean |
Menentukan apakah bisnis mendukung opsi tempat duduk di dalam atau di luar ruangan. |
|
opsional | PlaceEditorialSummary |
Berisi ringkasan tempat. Ringkasan terdiri dari ringkasan tekstual, dan juga menyertakan kode bahasa untuk ringkasan ini jika berlaku. Teks ringkasan harus ditampilkan apa adanya dan tidak dapat dimodifikasi atau diubah. Lihat PlaceEditorialSummary untuk mengetahui informasi selengkapnya. |
|
opsional | string |
String yang berisi alamat tempat ini yang dapat dibaca manusia. Sering kali alamat ini sama dengan alamat pos. Perhatikan bahwa beberapa negara, seperti Inggris Raya, tidak mengizinkan distribusi alamat pos sebenarnya karena adanya pembatasan pemberian lisensi. Alamat yang diformat secara logis terdiri dari satu atau beberapa komponen alamat. Misalnya, alamat "111 8th Avenue, New York, NY" terdiri atas komponen berikut: "111" (nomor jalan), "8th Avenue" (rute), "New York" (kota), dan "NY" (negara bagian AS). Jangan mengurai alamat berformat secara terprogram. Sebagai gantinya, Anda harus menggunakan komponen alamat individual, yang disertakan oleh respons API selain kolom alamat yang diformat. |
|
opsional | string |
Berisi nomor telepon tempat dalam format lokalnya. |
|
opsional | Geometry |
Berisi lokasi dan area pandang untuk lokasi tersebut. Lihat |
|
opsional | string |
Berisi URL ikon yang disarankan yang dapat ditampilkan kepada pengguna saat menunjukkan hasil ini di peta. |
|
opsional | string |
Berisi kode warna heksadesimal default untuk kategori tempat. |
|
opsional | string |
Berisi URL ikon yang direkomendasikan, tanpa ekstensi jenis file |
|
opsional | string |
Berisi nomor telepon tempat tersebut dalam format internasional.
Format internasional menyertakan kode negara dan diawali dengan tanda tambah (+). Misalnya, international_phone_number untuk kantor Google di Sydney, Australia adalah |
|
opsional | string |
Berisi nama yang dapat dibaca manusia untuk hasil yang ditampilkan. Untuk hasil |
|
opsional | PlaceOpeningHours |
Berisi jam operasional reguler. Lihat PlaceOpeningHours untuk mengetahui informasi selengkapnya. |
|
opsional | boolean |
Gunakan |
|
opsional | Array<PlacePhoto> |
Array objek foto, yang masing-masing berisi referensi ke gambar. Permintaan dapat menampilkan hingga sepuluh foto. Informasi selengkapnya tentang foto tempat dan cara menggunakan gambar di aplikasi Anda dapat ditemukan di dokumentasi Foto Tempat. Lihat PlacePhoto untuk mengetahui informasi selengkapnya. |
|
opsional | string |
Sebuah identifier tekstual yang secara unik mengidentifikasi tempat. Untuk mengambil informasi tentang tempat, teruskan ID ini di kolom |
|
opsional | PlusCode |
Referensi lokasi yang dienkode, yang berasal dari koordinat lintang dan bujur, yang mewakili area: 1/8000 derajat x 1/8000 derajat (sekitar 14 m x 14 m di khatulistiwa) atau lebih kecil. Plus Codes dapat digunakan sebagai pengganti alamat di tempat tanpa alamat jelas (jika bangunan tidak diberi nomor atau jalan tidak diberi nama). Lihat Open Location Code dan plus codes. Lihat |
|
opsional | angka |
Tingkat harga tempat, dalam skala 0 hingga 4. Jumlah persis yang ditunjukkan oleh nilai tertentu akan bervariasi dari satu wilayah ke wilayah lainnya. Tingkat harga ditafsirkan sebagai berikut:
|
|
opsional | angka |
Berisi rating tempat, dari 1,0 hingga 5,0, berdasarkan gabungan ulasan pengguna. |
|
opsional | string | |
|
opsional | boolean |
Menentukan apakah tempat mendukung reservasi. |
|
opsional | Array<PlaceReview> |
Array JSON yang dapat berisi hingga lima ulasan. Secara default, ulasan diurutkan berdasarkan relevansi. Gunakan parameter permintaan
Google merekomendasikan untuk menunjukkan kepada pengguna apakah hasil diurutkan berdasarkan
Lihat PlaceReview untuk mengetahui informasi selengkapnya. |
|
opsional | string | |
|
opsional | Array<PlaceOpeningHours> |
Berisi array entri untuk tujuh hari ke depan, termasuk informasi tentang jam buka sekunder bisnis. Jam buka sekunder berbeda dengan jam buka utama bisnis. Misalnya, restoran dapat menentukan jam drive-through atau jam pesan antar sebagai jam sekunder. Kolom ini mengisi subkolom Lihat PlaceOpeningHours untuk mengetahui informasi selengkapnya. |
|
opsional | boolean |
Menentukan apakah tempat tersebut menyajikan bir. |
|
opsional | boolean |
Menentukan apakah tempat menyajikan sarapan. |
|
opsional | boolean |
Menentukan apakah tempat menyajikan brunch. |
|
opsional | boolean |
Menentukan apakah tempat tersebut menyajikan makan malam. |
|
opsional | boolean |
Menentukan apakah tempat tersebut menyajikan makan siang. |
|
opsional | boolean |
Menentukan apakah tempat tersebut menyajikan makanan vegetarian. |
|
opsional | boolean |
Menentukan apakah tempat menyajikan wine. |
|
opsional | boolean |
Menentukan apakah bisnis mendukung layanan pesan bawa pulang. |
|
opsional | Array<string> |
Berisi array jenis fitur yang menjelaskan hasil yang diberikan. Lihat daftar jenis yang didukung. |
|
opsional | string |
Berisi URL halaman Google resmi untuk tempat ini. Halaman ini adalah halaman milik Google berisi informasi terbaik yang tersedia tentang tempat ini. Aplikasi harus menautkan ke atau menyematkan halaman ini pada setiap layar yang menampilkan hasil detail tentang tempat tersebut kepada pengguna. |
|
opsional | angka |
Jumlah total ulasan, dengan atau tanpa teks, untuk tempat ini. |
|
opsional | angka |
Berisi offset jumlah menit antara zona waktu tempat ini sekarang dari UTC. Misalnya, untuk tempat di Sydney, Australia saat terjadi penyesuaian waktu musim panas akan menjadi 660 (+11 jam dari UTC), dan untuk tempat di California di luar penyesuaian waktu musim panas akan menjadi -480 (-8 jam dari UTC). |
|
opsional | string |
Untuk hasil fasilitas (
Untuk semua hasil lainnya, kolom Konten ini ditujukan untuk dibaca apa adanya. Jangan mengurai alamat berformat secara terprogram. |
|
opsional | string |
Situs resmi untuk tempat ini, seperti halaman beranda bisnis. |
|
opsional | boolean |
Menentukan apakah tempat tersebut memiliki pintu masuk yang dapat diakses pengguna kursi roda. |
PlaceEditorialSummary
Berisi ringkasan tempat. Ringkasan terdiri dari ringkasan tekstual, dan juga menyertakan kode bahasa untuk ringkasan ini jika berlaku. Teks ringkasan harus disajikan apa adanya dan tidak dapat diubah atau dimodifikasi.
| Kolom | Wajib | Jenis | Deskripsi |
|---|---|---|---|
|
opsional | string |
Bahasa kolom sebelumnya. Mungkin tidak selalu ada. |
|
opsional | string |
Ringkasan tekstual panjang sedang tentang tempat tersebut. |
PlaceOpeningHours
Objek yang menjelaskan jam buka suatu tempat.
| Kolom | Wajib | Jenis | Deskripsi |
|---|---|---|---|
|
opsional | boolean |
Nilai boolean yang menunjukkan apakah tempat tersebut buka pada waktu saat ini. |
|
opsional | Array<PlaceOpeningHoursPeriod> |
Array jangka waktu buka yang mencakup tujuh hari, mulai dari hari Minggu, dalam urutan kronologis. Lihat PlaceOpeningHoursPeriod untuk mengetahui informasi selengkapnya. |
|
opsional | Array<PlaceSpecialDay> |
Array yang berisi hingga tujuh entri yang sesuai dengan tujuh hari ke depan. Lihat PlaceSpecialDay untuk mengetahui informasi selengkapnya. |
|
opsional | string |
String jenis yang digunakan untuk mengidentifikasi jenis jam buka sekunder (misalnya, |
|
opsional | Array<string> |
Array string yang menjelaskan jam buka tempat dalam teks yang dapat dibaca manusia. |
PlaceOpeningHoursPeriod
| Kolom | Wajib | Jenis | Deskripsi |
|---|---|---|---|
|
required | PlaceOpeningHoursPeriodDetail |
Berisi pasangan objek hari dan waktu yang menjelaskan kapan tempat tersebut buka. Lihat PlaceOpeningHoursPeriodDetail untuk mengetahui informasi selengkapnya. |
|
opsional | PlaceOpeningHoursPeriodDetail |
Dapat berisi pasangan objek hari dan waktu yang menjelaskan kapan tempat tersebut tutup. Jika tempat selalu buka, bagian tutup tidak akan ada dalam respons. Klien dapat selalu berpatokan pada kondisi selalu-buka yang direpresentasikan sebagai jangka waktu buka yang berisi hari dengan nilai Lihat PlaceOpeningHoursPeriodDetail untuk mengetahui informasi selengkapnya. |
PlaceSpecialDay
| Kolom | Wajib | Jenis | Deskripsi |
|---|---|---|---|
|
opsional | string |
Tanggal yang dinyatakan dalam format RFC3339 dalam zona waktu lokal untuk tempat tersebut, misalnya 2010-12-31. |
|
opsional | boolean |
True jika ada jam buka khusus untuk hari ini. Jika
|
PlaceOpeningHoursPeriodDetail
| Kolom | Wajib | Jenis | Deskripsi |
|---|---|---|---|
|
required | angka |
Angka 0–6, yang menyatakan hari-hari dalam seminggu, mulai hari Minggu. Misalnya, 2 berarti Selasa. |
|
required | string |
Dapat berisi waktu dalam sehari dalam format 24 jam jjmm. Nilai berada dalam rentang 0000–2359. Waktu akan dilaporkan dalam zona waktu tempat tersebut. |
|
opsional | string |
Tanggal yang dinyatakan dalam format RFC3339 dalam zona waktu lokal untuk tempat tersebut, misalnya 2010-12-31. |
|
opsional | boolean |
True jika periode tertentu terpotong karena batas tujuh hari, dengan periode dimulai sebelum tengah malam pada tanggal permintaan dan/atau berakhir pada atau setelah tengah malam pada hari terakhir. Properti ini menunjukkan bahwa periode buka atau tutup dapat diperpanjang melewati batas tujuh hari ini. |
PlacePhoto
Foto Tempat. Foto dapat diakses menggunakan Place Photo API menggunakan URL dalam pola berikut:
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY
Lihat Foto Tempat untuk mengetahui informasi selengkapnya.
| Kolom | Wajib | Jenis | Deskripsi |
|---|---|---|---|
|
required | angka |
Tinggi foto. |
|
required | Array<string> |
Atribusi HTML untuk foto. |
|
required | string |
String yang digunakan untuk mengidentifikasi foto saat Anda melakukan permintaan Foto. |
|
required | angka |
Lebar foto. |
PlaceReview
Ulasan tempat yang dikirimkan oleh pengguna.
| Kolom | Wajib | Jenis | Deskripsi |
|---|---|---|---|
|
required | string |
Nama pengguna yang mengirim ulasan. Ulasan anonim diatribusikan ke "Pengguna Google". |
|
required | angka |
Rating pengguna secara keseluruhan untuk tempat ini. Rating ini menggunakan bilangan bulat, berkisar dari 1 hingga 5. |
|
required | string |
Waktu pengiriman ulasan dalam teks, relatif terhadap waktu saat ini. |
|
required | angka |
Waktu pengiriman ulasan, diukur dalam jumlah detik sejak tengah malam, 1 Januari 1970 UTC. |
|
opsional | string |
URL ke profil Local Guides Google Maps pengguna, jika tersedia. |
|
opsional | string |
Kode bahasa IETF yang menunjukkan bahasa ulasan yang ditampilkan.Kolom ini hanya berisi tag bahasa utama, dan bukan tag sekunder yang menunjukkan negara atau wilayah. Misalnya, semua ulasan dalam bahasa Inggris akan diberi tag 'en', dan bukan 'en-AU' atau 'en-UK' dan seterusnya.Kolom ini kosong jika hanya ada rating tanpa teks ulasan. |
|
opsional | string |
Kode bahasa IETF yang menunjukkan bahasa asli ulasan. Jika ulasan telah diterjemahkan, |
|
opsional | string |
URL ke foto profil pengguna, jika tersedia. |
|
opsional | string |
Ulasan pengguna. Saat mengulas sebuah lokasi dengan Google Places, ulasan teks dianggap opsional. Oleh karena itu, kolom ini mungkin kosong. Perhatikan bahwa kolom ini dapat menyertakan markup HTML dasar. Misalnya, referensi entity |
|
opsional | boolean |
Nilai boolean yang menunjukkan apakah ulasan diterjemahkan dari bahasa asli yang digunakan untuk menulisnya.Jika ulasan telah diterjemahkan, yang sesuai dengan nilai true, Google merekomendasikan agar Anda menunjukkan hal ini kepada pengguna. Misalnya, Anda dapat menambahkan string berikut, "Diterjemahkan oleh Google", ke ulasan. |