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)xmlmenunjukkan 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
textqueryatauphonenumber. 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 mendapatkanplace_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,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. -
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
languagetidak diberikan, API akan mencoba menggunakan bahasa pilihan seperti yang ditentukan dalam headerAccept-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.
-
Bias IP: Memerintahkan API untuk menggunakan bias alamat IP. Teruskan string
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
|
|
opsional | Array<string> |
Jika layanan menampilkan informasi tambahan tentang spesifikasi permintaan, mungkin ada kolom |
PlacesSearchStatus
Kode status yang ditampilkan oleh layanan.
OKyang menunjukkan bahwa permintaan API berhasil.-
ZERO_RESULTSyang menunjukkan bahwa penelusuran berhasil, tetapi tidak menampilkan hasil. Hal ini dapat terjadi jika penelusuran meneruskanlatlngdi lokasi terpencil. -
INVALID_REQUESTyang menunjukkan bahwa permintaan API salah format, biasanya karena parameter kueri yang diperlukan (locationatauradius) tidak ada. -
OVER_QUERY_LIMITyang 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).
-
REQUEST_DENIEDyang menunjukkan bahwa permintaan Anda ditolak, biasanya karena:- Permintaan tidak berisi kunci API.
- Parameter
keytidak valid.
UNKNOWN_ERRORmenunjukkan 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 |
|
opsional | string |
Representasi alamat tempat dalam microformat 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 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
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 |
|
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 |
|
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 |
|
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 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
|
|
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 |
|
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:
|
|
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
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 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 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 (
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 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, |
|
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 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
|
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
|
|
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 |
|
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. |