Find Place (Lama)

Developer Wilayah Ekonomi Eropa (EEA)

Permintaan Find Place (Lama) menggunakan input teks dan menampilkan tempat. Input dapat berupa segala jenis data teks Tempat, seperti nama, alamat, atau nomor telepon. Permintaan harus berupa string. Permintaan Cari Tempat (Lama) yang menggunakan data non-string seperti koordinat lat/lng atau kode plus akan menghasilkan error.

Permintaan Find Place (Lama)

Permintaan Find Place (Legacy) adalah URL HTTP dengan bentuk berikut:

https://maps.googleapis.com/maps/api/place/findplacefromtext/output?parameters

dengan output dapat berupa salah satu nilai berikut:

  • json (direkomendasikan) menunjukkan output dalam JavaScript Object Notation (JSON)
  • xml menunjukkan output sebagai XML

Parameter tertentu diperlukan untuk memulai permintaan Find Place (Lama). Sesuai dengan standar dalam URL, semua parameter dipisahkan menggunakan karakter ampersand (&).

Parameter yang diperlukan

  • input

    String teks yang digunakan untuk menelusuri, misalnya: "restaurant" atau "123 Main Street". String ini harus berupa nama tempat, alamat, atau kategori tempat usaha. Jenis input lainnya dapat menghasilkan error dan tidak dijamin akan menampilkan hasil yang valid. Places API akan menampilkan kandidat hasil berdasarkan string ini dan mengurutkan hasil berdasarkan relevansi yang terlihat.

  • inputtype

    Jenis input. Nilai ini dapat berupa salah satu dari textquery atau phonenumber. Nomor telepon harus dalam format internasional (diawali dengan tanda plus ("+"), yang diikuti dengan kode negara, lalu nomor telepon itu sendiri). Lihat Rekomendasi ITU E.164 untuk mengetahui informasi selengkapnya.

Parameter opsional

  • Fields

    Perhatian: Permintaan Place Search dan Place Details tidak menampilkan kolom yang sama. Permintaan Place Search menampilkan subset kolom yang ditampilkan berdasarkan permintaan Place Details. Jika kolom yang Anda inginkan tidak ditampilkan oleh Place Search, Anda dapat menggunakan Place Search untuk mendapatkan place_id, lalu menggunakan ID Tempat tersebut untuk membuat permintaan Place Details. Untuk mengetahui informasi selengkapnya tentang kolom yang tidak tersedia dalam permintaan Place Search, lihat Dukungan kolom Places API.

    Gunakan parameter kolom untuk menentukan daftar jenis data tempat yang dipisahkan koma yang akan 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. Kolom Basic ditagih dengan tarif dasar, sedangkan kolom Contact dan Atmosphere ditagih dengan tarif yang lebih tinggi. SKU Basic, Contact, dan Atmosphere dikenai biaya selain SKU dasar (Places Details, Find Place, Nearby Search, atau Text Search) untuk permintaan yang memicunya. Untuk informasi selengkapnya, lihat lembar 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, website

    Atmosphere

    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.
  • language

    Bahasa yang digunakan untuk menampilkan hasil.

    • Lihat daftar bahasa yang didukung. Google sering memperbarui bahasa yang didukung, sehingga daftar ini mungkin tidak lengkap.
    • Jika language tidak diberikan, API akan mencoba menggunakan bahasa pilihan seperti yang ditentukan dalam header Accept-Language.
    • API ini berupaya sebaik mungkin untuk memberikan alamat jalan yang dapat dibaca oleh pengguna dan penduduk setempat. Untuk mencapai tujuan tersebut, API ini menampilkan alamat jalan dalam bahasa lokal, yang ditransliterasi ke skrip yang dapat dibaca oleh pengguna jika perlu, dengan memperhatikan 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 sedikit pengaruh pada kumpulan hasil yang dipilih API untuk ditampilkan, dan urutan penampilannya. 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.
  • locationbias

    Lebih memilih hasil di area tertentu, dengan menentukan radius plus lintang/bujur, atau dua pasangan lintang/bujur yang merepresentasikan titik-titik persegi panjang. Jika parameter ini tidak ditentukan, API akan menggunakan penyesuaian alamat IP secara default.

    • Bias IP: Memerintahkan API untuk menggunakan bias alamat IP. Teruskan string ipbias (opsi ini tidak memiliki parameter tambahan).
    • Lingkaran: String yang menentukan radius dalam meter, ditambah lintang/bujur dalam derajat desimal. Gunakan format berikut: circle:radius@lat,lng.
    • Persegi panjang: String yang menentukan dua pasangan lintang/bujur dalam derajat desimal, yang merepresentasikan titik selatan/barat dan utara/timur dari persegi panjang. Gunakan format berikut:rectangle:south,west|north,east. Perhatikan bahwa nilai timur/barat dibatasi ke rentang -180, 180, dan nilai utara/selatan dibatasi ke rentang -90, 90.

Contoh Find Place (Lama)

Contoh berikut menunjukkan permintaan Find Place (Lama) untuk "Museum of Contemporary Art Australia", yang mencakup kolom photos, formatted_address, name, rating, opening_hours, dan geometry:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

Contoh berikut menunjukkan permintaan Find Place (Legacy) untuk "Mongolian Grill", menggunakan parameter locationbias untuk lebih memilih hasil dalam jarak 2.000 meter dari koordinat yang ditentukan:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

Contoh berikut menunjukkan permintaan Find Place (Legacy) untuk nomor telepon. Perhatikan bahwa awalan panggilan internasional "+" telah dienkode menjadi %2B sehingga permintaan ini menjadi URL yang sesuai. Jika tidak dienkode, awalan + akan didekode menjadi spasi di server, sehingga menghasilkan pencarian nomor telepon yang tidak valid.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

Respons Find Place (Lama)

Respons Find Place (Legacy) hanya berisi jenis data yang ditentukan menggunakan parameter fields, ditambah html_attributions. Contoh berikut menunjukkan respons untuk permintaan Cari Tempat (Lama) untuk "Museum of Contemporary Art Australia", termasuk kolom formatted_address, geometry, name, opening_hours, photos, rating.

JSON

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}    

XML

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

    

PlacesFindPlaceFromTextResponse

Kolom Wajib Jenis Deskripsi
wajib ada Array<Place>

Berisi array kandidat Tempat.

Permintaan Place Search menampilkan subset kolom yang ditampilkan berdasarkan permintaan Place Details. Jika kolom yang Anda inginkan tidak ditampilkan oleh Place Search, Anda dapat menggunakan Place Search untuk mendapatkan place_id, lalu menggunakan ID Tempat tersebut untuk membuat permintaan Place Details.

Lihat Tempat untuk mengetahui informasi selengkapnya.

wajib ada PlacesSearchStatus

Berisi status permintaan, dan mungkin berisi informasi proses debug untuk membantu Anda melacak penyebab kegagalan permintaan.

Lihat PlacesSearchStatus untuk mengetahui informasi selengkapnya.

opsional string

Jika layanan menampilkan kode status selain OK<, mungkin ada kolom error_message tambahan dalam objek respons. Kolom ini berisi informasi yang lebih mendetail tentang alasan di balik kode status yang diberikan. Kolom ini tidak selalu ditampilkan, dan kontennya dapat berubah.

opsional Array<string>

Jika layanan menampilkan informasi tambahan tentang spesifikasi permintaan, mungkin ada kolom info_messages tambahan dalam objek respons. Kolom ini hanya ditampilkan untuk permintaan yang berhasil. Konten ini mungkin tidak selalu ditampilkan, dan isinya dapat berubah.

PlacesSearchStatus

Kode status yang ditampilkan oleh layanan.

  • OK yang menunjukkan bahwa permintaan API berhasil.
  • ZERO_RESULTS yang menunjukkan bahwa penelusuran berhasil, tetapi tidak menampilkan hasil. Hal ini dapat terjadi jika penelusuran meneruskan latlng di lokasi terpencil.
  • INVALID_REQUEST yang menunjukkan bahwa permintaan API salah format, biasanya karena parameter kueri yang diperlukan (location atau radius) tidak ada.
  • OVER_QUERY_LIMIT yang menunjukkan salah satu dari berikut ini:
    • 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).
    Lihat FAQ Maps untuk mengetahui informasi selengkapnya tentang cara mengatasi error ini.
  • REQUEST_DENIED yang menunjukkan bahwa permintaan Anda ditolak, biasanya karena:
    • Permintaan tidak berisi kunci API.
    • Parameter key tidak valid.
  • UNKNOWN_ERROR menunjukkan error yang tidak diketahui.

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 AddressComponent untuk mengetahui informasi selengkapnya.

opsional string

Representasi alamat tempat dalam microformat adr.

opsional string

Menunjukkan status operasional tempat, jika berupa bisnis. Jika tidak ada data, business_status tidak akan ditampilkan.

The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
opsional boolean

Menentukan apakah bisnis mendukung pengambilan di tepi jalan.

opsional PlaceOpeningHours

Berisi jam buka selama tujuh hari ke depan (termasuk hari ini). Periode waktu dimulai pada tengah malam pada tanggal permintaan dan berakhir pada pukul 23.59 enam hari kemudian. Kolom ini mencakup sub-kolom special_days dari semua jam, yang ditetapkan untuk tanggal yang memiliki jam buka khusus.

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 berbentuk teks, dan juga menyertakan kode bahasa untuk ringkasan tersebut 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 orang.

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 Amerika Serikat).

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 lokal.

opsional Geometry

Berisi lokasi dan area tampilan untuk lokasi.

Lihat Geometry untuk mengetahui informasi selengkapnya.

opsional string

Berisi URL ikon yang disarankan yang dapat ditampilkan kepada pengguna saat menunjukkan hasil ini di peta.

opsional string

Berisi kode warna HEX default untuk kategori tempat.

opsional string

Berisi URL ikon yang direkomendasikan, tanpa ekstensi jenis file .svg atau .png.

opsional string

Berisi nomor telepon tempat tersebut dalam format internasional. Format internasional menyertakan kode negara, dan diawali dengan tanda plus, +, . Misalnya, international_phone_number untuk kantor Google di Sydney, Australia adalah +61 2 9374 4000.

opsional string

Berisi nama yang dapat dibaca manusia untuk hasil yang ditampilkan. Untuk hasil establishment, biasanya ini adalah nama bisnis kanonis.

opsional PlaceOpeningHours

Berisi jam operasional reguler.

Lihat PlaceOpeningHours untuk mengetahui informasi selengkapnya.

opsional boolean

Gunakan business_status untuk mendapatkan status operasional bisnis.

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 dalam 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 place_id pada permintaan Places API. Untuk mengetahui informasi selengkapnya tentang ID tempat, lihat ringkasan ID tempat.

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 yang tidak memiliki alamat (jika bangunan tidak diberi nomor atau jalan tidak diberi nama). Lihat Open Location Code dan plus codes.

Lihat PlusCode untuk mengetahui informasi selengkapnya.

opsional angka

Tingkat harga tempat, pada skala 0 hingga 4. Jumlah persis yang ditunjukkan oleh nilai tertentu akan bervariasi dari wilayah ke wilayah. Tingkat harga ditafsirkan sebagai berikut:

  • 0 Gratis
  • 1 Murah
  • 2 Sedang
  • 3 Mahal
  • 4 Sangat Mahal
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 berisi hingga lima ulasan. Secara default, ulasan diurutkan berdasarkan relevansi. Gunakan parameter permintaan reviews_sort untuk mengontrol pengurutan.

  • Untuk most_relevant (default), ulasan diurutkan berdasarkan relevansi; layanan akan memihak hasil untuk menampilkan ulasan yang awalnya ditulis dalam bahasa pilihan.
  • Untuk newest, ulasan diurutkan dalam urutan kronologis; bahasa pilihan tidak memengaruhi urutan pengurutan.

Google merekomendasikan untuk menunjukkan kepada pengguna apakah hasil diurutkan berdasarkan most_relevant atau newest.

Lihat PlaceReview untuk mengetahui informasi selengkapnya.

opsional string
opsional Array<PlaceOpeningHours>

Berisi array entri untuk tujuh hari berikutnya, termasuk informasi tentang jam buka sekunder bisnis. Jam sekunder berbeda dengan jam buka utama bisnis. Misalnya, restoran dapat menentukan jam layanan drive-through atau jam pengiriman sebagai jam buka sekunder. Kolom ini mengisi subkolom type, yang diambil dari daftar jenis jam buka yang telah ditentukan sebelumnya (seperti DRIVE_THROUGH, PICKUP, atau TAKEOUT) berdasarkan jenis tempat. Kolom ini mencakup sub-kolom special_days dari semua jam, yang ditetapkan untuk tanggal yang memiliki jam buka khusus.

Lihat PlaceOpeningHours untuk mengetahui informasi selengkapnya.

opsional boolean

Menentukan apakah tempat ini menyajikan bir.

opsional boolean

Menentukan apakah tempat ini menyajikan sarapan.

opsional boolean

Menentukan apakah tempat menyajikan brunch.

opsional boolean

Menentukan apakah tempat menyajikan makan malam.

opsional boolean

Menentukan apakah tempat ini menyajikan makan siang.

opsional boolean

Menentukan apakah tempat ini menyajikan makanan vegetarian.

opsional boolean

Menentukan apakah tempat menyajikan wine.

opsional boolean

Menentukan apakah bisnis mendukung layanan pesan bawa.

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 yang berisi informasi terbaik yang tersedia tentang tempat tersebut. 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 jumlah menit selisih zona waktu tempat ini saat ini 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 khusus tempat usaha (types:["establishment", ...])), kolom vicinity berisi alamat yang disederhanakan untuk tempat, termasuk nama jalan, nomor jalan, dan lokalitas, tetapi bukan provinsi/negara bagian, kode pos, atau negara.

Untuk semua hasil lainnya, kolom vicinity berisi nama fitur politik (types:["political", ...]) tersempit yang ada di alamat hasil.

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 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 tersebut jika berlaku. Teks ringkasan harus ditampilkan 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 tempat yang panjangnya sedang.

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 hingga tujuh entri yang sesuai dengan tujuh hari berikutnya.

Lihat PlaceSpecialDay untuk mengetahui informasi selengkapnya.

opsional string

String jenis yang digunakan untuk mengidentifikasi jenis jam buka sekunder (misalnya, DRIVE_THROUGH, HAPPY_HOUR, DELIVERY, TAKEOUT, KITCHEN, BREAKFAST, LUNCH, DINNER, BRUNCH, PICKUP, SENIOR_HOURS). Ditetapkan hanya untuk secondary_opening_hours.

opsional Array<string>

Array string yang menjelaskan jam buka tempat dalam teks yang dapat dibaca manusia.

PlaceOpeningHoursPeriod

Kolom Wajib Jenis Deskripsi
wajib ada PlaceOpeningHoursPeriodDetail

Berisi sepasang objek hari dan waktu yang menjelaskan kapan tempat buka.

Lihat PlaceOpeningHoursPeriodDetail untuk mengetahui informasi selengkapnya.

opsional PlaceOpeningHoursPeriodDetail

Dapat berisi pasangan objek hari dan waktu yang menjelaskan kapan tempat tutup. Jika tempat selalu buka, bagian tutup akan hilang dari respons. Klien dapat selalu berpatokan pada kondisi selalu-buka yang direpresentasikan sebagai jangka waktu buka yang berisi hari dengan nilai 0 dan waktu dengan nilai 0000, dan tanpa close.

Lihat PlaceOpeningHoursPeriodDetail untuk mengetahui informasi selengkapnya.

PlaceSpecialDay

Kolom Wajib Jenis Deskripsi
opsional string

Tanggal yang dinyatakan dalam format RFC3339 di zona waktu lokal untuk tempat, misalnya 2010-12-31.

opsional boolean

Benar jika ada jam buka khusus untuk hari ini. Jika true, berarti ada setidaknya satu pengecualian untuk hari ini. Pengecualian menyebabkan nilai yang berbeda muncul di sub-kolom current_opening_hours dan secondary_opening_hours seperti periods, weekday_text, open_now. Pengecualian berlaku untuk jam, dan jam digunakan untuk membuat kolom lainnya.

PlaceOpeningHoursPeriodDetail

Kolom Wajib Jenis Deskripsi
wajib ada angka

Angka 0–6, yang menyatakan hari-hari dalam seminggu, mulai hari Minggu. Misalnya, 2 berarti Selasa.

wajib ada 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 di zona waktu lokal untuk tempat, misalnya 2010-12-31.

opsional boolean

Benar jika periode tertentu dipangkas 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 untuk buka atau tutup dapat melampaui batas tujuh hari ini.

PlacePhoto

Foto suatu Tempat. Foto dapat diakses menggunakan Place Photo API menggunakan URL dengan 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
wajib ada angka

Tinggi foto.

wajib ada Array<string>

Atribusi HTML untuk foto.

wajib ada string

String yang digunakan untuk mengidentifikasi foto saat Anda melakukan permintaan Foto.

wajib ada angka

Lebar foto.

PlaceReview

Ulasan tempat yang dikirimkan oleh pengguna.

Kolom Wajib Jenis Deskripsi
wajib ada string

Nama pengguna yang mengirim ulasan. Ulasan anonim diatribusikan ke "Pengguna Google".

wajib ada angka

Rating pengguna secara keseluruhan untuk tempat ini. Ini adalah bilangan bulat, berkisar dari 1 hingga 5.

wajib ada string

Waktu ulasan dikirimkan dalam teks, relatif terhadap waktu saat ini.

wajib ada angka

Waktu saat ulasan dikirimkan, diukur dalam jumlah detik sejak tengah malam, 1 Januari 1970 UTC.

opsional string

URL ke profil Local Guide 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, maka original_language != language.Kolom ini hanya berisi tag bahasa utama, dan bukan tag sekunder yang menunjukkan negara atau wilayah. Misalnya, semua ulasan dalam bahasa Inggris diberi tag 'en', dan bukan 'en-AU' atau 'en-UK' dan seterusnya.Kolom ini kosong jika hanya ada rating tanpa teks ulasan.

opsional string

URL ke foto profil pengguna, jika tersedia.

opsional string

Ulasan pengguna. Saat mengulas 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 &amp; dapat merepresentasikan karakter ampersand.

opsional boolean

Nilai boolean yang menunjukkan apakah ulasan diterjemahkan dari bahasa aslinya.Jika ulasan telah diterjemahkan, sesuai dengan nilai benar (true), Google merekomendasikan agar Anda menunjukkannya kepada pengguna. Misalnya, Anda dapat menambahkan string berikut, "Diterjemahkan oleh Google", ke ulasan.