Class PlacesService
Class
google.maps.places.PlacesService
Berisi metode yang terkait dengan penelusuran tempat dan pengambilan detail tentang suatu tempat.
Muat menggunakan parameter URL &libraries=places
. Lihat Library di Maps JavaScript API.
Saat menggunakan v=beta
, dapat diakses dengan memanggil const {PlacesService} = await google.map.importLibrary("places")
. Lihat Library di Maps JavaScript API.
Konstruktor | |
---|---|
PlacesService |
PlacesService(attrContainer) Parameter:
Membuat instance PlacesService baru yang merender atribusi dalam penampung yang ditentukan. |
Metode | |
---|---|
findPlaceFromPhoneNumber |
findPlaceFromPhoneNumber(request, callback) Parameter:
Nilai Hasil: Tidak Ada
Mengambil daftar tempat berdasarkan nomor telepon. Pada umumnya, hanya ada satu item dalam daftar hasil. Namun, jika permintaan tersebut ambigu, lebih dari satu hasil dapat ditampilkan. PlaceResult yang diteruskan ke callback adalah subset dari PlaceResult lengkap. Aplikasi Anda bisa mendapatkan PlaceResult yang lebih mendetail untuk setiap tempat dengan memanggil PlacesService.getDetails dan meneruskan PlaceResult.place_id untuk tempat yang diinginkan. |
findPlaceFromQuery |
findPlaceFromQuery(request, callback) Parameter:
Nilai Hasil: Tidak Ada
Mengambil daftar tempat berdasarkan string kueri. Pada umumnya, hanya ada satu item dalam daftar hasil. Namun, jika permintaan tersebut ambigu, lebih dari satu hasil dapat ditampilkan. PlaceResult yang diteruskan ke callback adalah subset dari PlaceResult lengkap. Aplikasi Anda bisa mendapatkan PlaceResult yang lebih mendetail untuk setiap tempat dengan memanggil PlacesService.getDetails dan meneruskan PlaceResult.place_id untuk tempat yang diinginkan. |
getDetails |
getDetails(request, callback) Parameter:
Nilai Hasil: Tidak Ada
Mengambil detail tentang tempat yang diidentifikasi oleh placeId yang diberikan. |
nearbySearch |
nearbySearch(request, callback) Parameter:
Nilai Hasil: Tidak Ada
Mengambil daftar tempat di dekat lokasi tertentu, berdasarkan kata kunci atau jenis. Lokasi harus selalu ditentukan, dengan meneruskan parameter LatLngBounds , atau location dan radius . PlaceResult yang diteruskan ke callback adalah subset dari PlaceResult lengkap. Aplikasi Anda bisa mendapatkan PlaceResult yang lebih mendetail untuk setiap tempat dengan mengirimkan permintaan Place Details yang meneruskan PlaceResult.place_id untuk tempat yang diinginkan. Objek PlaceSearchPagination dapat digunakan untuk mengambil halaman hasil tambahan (null jika ini adalah halaman hasil terakhir atau jika hanya ada satu halaman hasil). |
textSearch |
textSearch(request, callback) Parameter:
Nilai Hasil: Tidak Ada
Mengambil daftar tempat berdasarkan string kueri (misalnya, "pizza in New York", atau "shoe stores near Ottawa"). Parameter lokasi bersifat opsional; jika lokasi ditentukan, hasil hanya dibiaskan terhadap hasil yang ditampilkan di sekitar, bukan terbatas pada tempat di dalam area tersebut. Gunakan textSearch jika Anda ingin menelusuri tempat menggunakan string arbitrer, dan jika Anda mungkin tidak ingin membatasi hasil penelusuran ke lokasi tertentu. Objek PlaceSearchPagination dapat digunakan untuk mengambil halaman hasil tambahan (null jika ini adalah halaman hasil terakhir atau jika hanya ada satu halaman hasil). |
Antarmuka PlaceDetailsRequest
Antarmuka google.maps.places.PlaceDetailsRequest
Kueri Place Details yang akan dikirim ke PlacesService
.
Properti | |
---|---|
placeId |
Jenis:
string ID Tempat yang detailnya diminta. |
fields optional |
Jenis:
Array<string> optional Kolom yang akan disertakan dalam respons detail, yang akan ditagih. Jika tidak ada kolom yang ditentukan atau ['ALL'] diteruskan, semua kolom yang tersedia akan dikembalikan dan ditagih (ini tidak direkomendasikan untuk deployment produksi). Untuk daftar kolom, lihat PlaceResult . Kolom bertingkat dapat ditentukan dengan jalur titik (misalnya, "geometry.location" ). |
language optional |
Jenis:
string optional ID bahasa untuk bahasa yang harus digunakan untuk menampilkan detail. Lihat daftar bahasa yang didukung. |
region optional |
Jenis:
string optional Kode wilayah wilayah pengguna. Hal ini dapat memengaruhi foto mana yang dapat ditampilkan, dan mungkin hal-hal lainnya. Kode wilayah menerima nilai dua karakter ccTLD ("domain level teratas"). Umumnya 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 "Inggris Raya dan Irlandia Utara"). |
sessionToken optional |
Jenis:
AutocompleteSessionToken optional Referensi unik yang digunakan untuk menggabungkan permintaan detail dengan sesi pelengkapan otomatis. |
Antarmuka FindPlaceFromScrollViewRequest
Antarmuka google.maps.places.FindPlaceFromPhoneNumberRequest
Tempat ditemukan dari permintaan penelusuran teks yang akan dikirim ke PlacesService.findPlaceFromPhoneNumber
.
Properti | |
---|---|
fields |
Jenis:
Array<string> Kolom yang akan disertakan dalam respons, yang akan ditagih. Jika ['ALL'] diteruskan, semua kolom yang tersedia akan dikembalikan dan ditagihkan (ini tidak direkomendasikan untuk deployment produksi). Untuk daftar kolom, lihat PlaceResult . Kolom bertingkat dapat ditentukan dengan jalur titik (misalnya, "geometry.location" ). |
phoneNumber |
Jenis:
string Nomor telepon tempat yang akan dicari. Formatnya harus E.164. |
language optional |
Jenis:
string optional ID bahasa untuk bahasa yang digunakan untuk menampilkan nama dan alamat, jika memungkinkan. Lihat daftar bahasa yang didukung. |
locationBias optional |
Jenis:
LocationBias optional Bias yang digunakan saat mencari Tempat. Hasilnya akan dibiaskan terhadap, namun tidak terbatas pada, LocationBias yang diberikan. |
Antarmuka FindPlaceFromQueryRequest
Antarmuka google.maps.places.FindPlaceFromQueryRequest
Tempat ditemukan dari permintaan penelusuran teks yang akan dikirim ke PlacesService.findPlaceFromQuery
.
Properti | |
---|---|
fields |
Jenis:
Array<string> Kolom yang akan disertakan dalam respons, yang akan ditagih. Jika ['ALL'] diteruskan, semua kolom yang tersedia akan dikembalikan dan ditagihkan (ini tidak direkomendasikan untuk deployment produksi). Untuk daftar kolom, lihat PlaceResult . Kolom bertingkat dapat ditentukan dengan jalur titik (misalnya, "geometry.location" ). |
query |
Jenis:
string Kueri permintaan. Misalnya, nama atau alamat tempat. |
language optional |
Jenis:
string optional ID bahasa untuk bahasa yang digunakan untuk menampilkan nama dan alamat, jika memungkinkan. Lihat daftar bahasa yang didukung. |
locationBias optional |
Jenis:
LocationBias optional Bias yang digunakan saat mencari Tempat. Hasilnya akan dibiaskan terhadap, namun tidak terbatas pada, LocationBias yang diberikan. |
Antarmuka PlaceSearchRequest
Antarmuka google.maps.places.PlaceSearchRequest
Kueri Place Search yang akan dikirim ke PlacesService
.
Properti | |
---|---|
bounds optional |
Jenis:
LatLngBounds|LatLngBoundsLiteral optional Batas saat menelusuri Tempat. location dan radius akan diabaikan jika bounds ditetapkan. |
keyword optional |
Jenis:
string optional Istilah yang akan dicocokkan dengan semua kolom yang tersedia, termasuk tetapi tidak terbatas pada nama, jenis, dan alamat, serta ulasan pelanggan dan konten pihak ketiga lainnya. |
language optional |
Jenis:
string optional ID bahasa untuk bahasa yang digunakan untuk menampilkan nama dan alamat, jika memungkinkan. Lihat daftar bahasa yang didukung. |
location optional |
Jenis:
LatLng|LatLngLiteral optional Lokasi sekitar untuk menelusuri Tempat. |
maxPriceLevel optional |
Jenis:
number optional Membatasi hasil hanya ke tempat yang berada di tingkat harga yang ditentukan atau lebih rendah. Nilai yang valid berkisar dari 0 (paling terjangkau) hingga 4 (paling mahal), inklusif. Harus lebih besar dari atau sama dengan minPrice , jika ditentukan. |
minPriceLevel optional |
Jenis:
number optional Membatasi hasil hanya pada tempat dengan tingkat harga yang ditentukan atau lebih tinggi. Nilai yang valid berkisar dari 0 (paling terjangkau) hingga 4 (paling mahal), inklusif. Harus lebih kecil dari atau sama dengan maxPrice , jika ditentukan. |
|
Jenis:
string optional Setara dengan keyword . Nilai di kolom ini digabungkan dengan nilai di kolom keyword dan diteruskan sebagai bagian dari string penelusuran yang sama. |
openNow optional |
Jenis:
boolean optional Membatasi hasil hanya pada tempat yang sedang buka saat ini. |
radius optional |
Jenis:
number optional Jarak dari lokasi yang diberikan untuk menelusuri Tempat, dalam meter. Nilai maksimum yang diizinkan adalah 50.000. |
rankBy optional |
Jenis:
RankBy optional Default:
RankBy.PROMINENCE Menentukan metode peringkat yang akan digunakan saat menampilkan hasil. Perhatikan bahwa saat rankBy ditetapkan ke DISTANCE , Anda harus menentukan location , tetapi Anda tidak dapat menentukan radius atau bounds . |
type optional |
Jenis:
string optional Menelusuri tempat dari jenis yang ditentukan. Jenis tersebut diterjemahkan ke dalam bahasa lokal lokasi target permintaan dan digunakan sebagai string kueri. Jika kueri juga disediakan, kueri akan digabungkan ke string jenis yang dilokalkan. Hasil berbagai jenis dihapus dari respons. Gunakan kolom ini untuk melakukan penelusuran kategoris independen bahasa dan wilayah. Jenis yang valid diberikan di sini. |
Antarmuka TextSearchRequest
Antarmuka google.maps.places.TextSearchRequest
Permintaan penelusuran teks yang akan dikirim ke PlacesService
.
Properti | |
---|---|
bounds optional |
Jenis:
LatLngBounds|LatLngBoundsLiteral optional Batas yang digunakan untuk membiaskan hasil saat menelusuri Tempat (opsional). location dan radius akan diabaikan jika bounds ditetapkan. Hasil tidak akan dibatasi untuk hasil yang berada di dalam batas tersebut; tetapi, hasil di dalamnya akan memiliki peringkat yang lebih tinggi. |
language optional |
Jenis:
string optional ID bahasa untuk bahasa yang digunakan untuk menampilkan nama dan alamat, jika memungkinkan. Lihat daftar bahasa yang didukung. |
location optional |
Jenis:
LatLng|LatLngLiteral optional Bagian tengah area yang digunakan untuk mencondongkan hasil saat menelusuri Tempat. |
query optional |
Jenis:
string optional Istilah kueri permintaan. Misalnya, nama tempat ('Menara Eiffel'), kategori yang diikuti dengan nama lokasi ('pizza di New York'), atau nama tempat diikuti dengan disambiguator lokasi ('Starbucks di Sydney'). |
radius optional |
Jenis:
number optional Radius area yang digunakan untuk membiaskan hasil saat menelusuri Tempat, dalam meter. |
region optional |
Jenis:
string optional Kode wilayah untuk membiaskan hasil. Kode wilayah menerima nilai dua karakter ccTLD ("domain level teratas"). Umumnya 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 "Inggris Raya dan Irlandia Utara"). |
type optional |
Jenis:
string optional Menelusuri tempat dari jenis yang ditentukan. Jenis tersebut diterjemahkan ke dalam bahasa lokal lokasi target permintaan dan digunakan sebagai string kueri. Jika kueri juga disediakan, kueri akan digabungkan ke string jenis yang dilokalkan. Hasil berbagai jenis dihapus dari respons. Gunakan kolom ini untuk melakukan penelusuran kategoris independen bahasa dan wilayah. Jenis yang valid diberikan di sini. |
Konstanta RankBy
Konstanta google.maps.places.RankBy
Opsi peringkat untuk PlaceSearchRequest.
Muat menggunakan parameter URL &libraries=places
. Lihat Library di Maps JavaScript API.
Saat menggunakan v=beta
, dapat diakses dengan memanggil const {RankBy} = await google.map.importLibrary("places")
. Lihat Library di Maps JavaScript API.
Konstanta | |
---|---|
DISTANCE |
Memberi peringkat pada hasil tempat menurut jarak dari lokasi. |
PROMINENCE |
Memberi peringkat pada hasil tempat berdasarkan keterlihatannya. |
LocationBias typedef
google.maps.places.LocationBias
typedef
LocationBiasa menunjukkan batas atau petunjuk yang dapat digunakan saat mencari Tempat. Hasil dapat berasal dari luar area yang ditentukan. Untuk menggunakan alamat IP pengguna saat ini sebagai bias, string "IP_BIAS"
dapat ditentukan. Catatan: jika menggunakan Circle
, pusat dan radius harus ditentukan.
LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
LocationRestriction
google.maps.places.LocationRestriction
typedef
LocationRestrictions mewakili batas ketat untuk digunakan saat menelusuri Places.
Konstanta PlacesServiceStatus
Konstanta google.maps.places.PlacesServiceStatus
Status yang ditampilkan oleh PlacesService
pada akhir penelusuran. Tentukan nilai ini menurut, atau dengan menggunakan nama konstanta. Misalnya, 'OK'
atau google.maps.places.PlacesServiceStatus.OK
.
Muat menggunakan parameter URL &libraries=places
. Lihat Library di Maps JavaScript API.
Saat menggunakan v=beta
, dapat diakses dengan memanggil const {PlacesServiceStatus} = await google.map.importLibrary("places")
. Lihat Library di Maps JavaScript API.
Konstanta | |
---|---|
INVALID_REQUEST |
Permintaan ini tidak valid. |
NOT_FOUND |
Tempat yang direferensikan tidak ditemukan. |
OK |
Respons berisi hasil yang valid. |
OVER_QUERY_LIMIT |
Aplikasi telah melampaui kuota permintaannya. |
REQUEST_DENIED |
Aplikasi tidak diizinkan menggunakan PlacesService . |
UNKNOWN_ERROR |
Permintaan PlacesService tidak dapat diproses karena terjadi error server. Permintaan mungkin berhasil jika Anda mencoba lagi. |
ZERO_RESULTS |
Tidak ada hasil yang ditemukan untuk permintaan ini. |
Antarmuka PlaceSearchPaginasi
Antarmuka google.maps.places.PlaceSearchPagination
Objek yang digunakan untuk mengambil halaman tambahan hasil Places.
Properti | |
---|---|
hasNextPage |
Jenis:
boolean Menunjukkan apakah hasil lebih lanjut tersedia. true saat ada halaman hasil tambahan. |
Metode | |
---|---|
nextPage |
nextPage() Parameter: Tidak ada
Nilai Hasil: Tidak Ada
Mengambil halaman hasil berikutnya. Menggunakan fungsi callback yang sama dengan yang diberikan untuk permintaan penelusuran pertama. |
Antarmuka PlaceResult
Antarmuka google.maps.places.PlaceResult
Menentukan informasi tentang Tempat.
Properti | |
---|---|
address_components optional |
Jenis:
Array<GeocoderAddressComponent> optional Kumpulan komponen alamat untuk lokasi Tempat ini. Hanya tersedia dengan PlacesService.getDetails . |
adr_address optional |
Jenis:
string optional Representasi alamat Tempat dalam microformat adr. Hanya tersedia dengan PlacesService.getDetails . |
aspects optional |
Jenis:
Array<PlaceAspectRating> optional Aspek yang dinilai dari Tempat ini, berdasarkan ulasan pengguna Google dan Zagat. Rating memiliki skala 0 hingga 30. |
business_status optional |
Jenis:
BusinessStatus optional Flag yang menunjukkan status operasional Tempat, jika berupa bisnis (menunjukkan apakah tempat tersebut beroperasi, atau tutup sementara atau permanen). Jika tidak ada data yang tersedia, tanda tidak ada dalam penelusuran atau respons detail. |
formatted_address optional |
Jenis:
string optional Alamat lengkap Tempat. |
formatted_phone_number optional |
Jenis:
string optional Nomor telepon Tempat, yang diformat sesuai dengan konvensi regional nomor. Hanya tersedia dengan PlacesService.getDetails . |
geometry optional |
Jenis:
PlaceGeometry optional Informasi terkait geometri Tempat. |
html_attributions optional |
Jenis:
Array<string> optional Teks atribusi yang akan ditampilkan untuk hasil Tempat ini. html_attributions yang tersedia selalu ditampilkan, terlepas dari fields yang diminta, dan harus ditampilkan. |
icon optional |
Jenis:
string optional URL ke resource gambar yang dapat digunakan untuk merepresentasikan kategori Tempat ini. |
icon_background_color optional |
Jenis:
string optional Warna latar belakang untuk digunakan dengan ikon Tempat. Lihat juga PlaceResult.icon_mask_base_uri . |
icon_mask_base_uri optional |
Jenis:
string optional URL terpotong menjadi mask ikon. Akses berbagai jenis ikon dengan menambahkan ekstensi file ke bagian akhir (yaitu .svg atau .png ). |
international_phone_number optional |
Jenis:
string optional Nomor telepon Place dalam format internasional. Format internasional menyertakan kode negara dan diawali dengan tanda tambah (+). Hanya tersedia dengan PlacesService.getDetails . |
name optional |
Jenis:
string optional Nama Tempat. Catatan: Jika pengguna memasukkan Tempat, ini adalah teks mentah, seperti yang diketik oleh pengguna. Hati-hati saat menggunakan data ini, karena pengguna berbahaya mungkin mencoba menggunakannya sebagai vektor untuk serangan injeksi kode (Lihat http://en.wikipedia.org/wiki/Code_injection). |
opening_hours optional |
Jenis:
PlaceOpeningHours optional Menentukan kapan Tempat terbuka atau tutup. |
|
Jenis:
boolean optional Tanda yang menunjukkan apakah Tempat sudah tutup, baik secara permanen maupun sementara. Jika tempat tersebut beroperasi, atau jika tidak ada data yang tersedia, tanda tidak ada dalam respons. |
photos optional |
Jenis:
Array<PlacePhoto> optional Foto Tempat ini. Koleksi akan berisi hingga sepuluh objek PlacePhoto . |
place_id optional |
Jenis:
string optional ID unik untuk Tempat. |
plus_code optional |
Jenis:
PlacePlusCode optional Menentukan Kode Lokasi Terbuka atau "plus Codes" untuk Tempat. |
price_level optional |
Jenis:
number optional Tingkat harga untuk Tempat, dalam skala 0 hingga 4. Tingkat harga diinterpretasikan sebagai berikut:
|
rating optional |
Jenis:
number optional Peringkat, antara 1,0 hingga 5,0, berdasarkan ulasan pengguna tentang Tempat ini. |
reviews optional |
Jenis:
Array<PlaceReview> optional Daftar ulasan Tempat ini. Hanya tersedia dengan PlacesService.getDetails . |
types optional |
Jenis:
Array<string> optional Array jenis untuk Tempat ini (misalnya, ["political", "locality"] atau ["restaurant", "establishment"] ). |
url optional |
Jenis:
string optional URL laman resmi Google untuk tempat ini. Ini adalah halaman milik Google berisi informasi terbaik yang tersedia tentang Tempat ini. Hanya tersedia dengan PlacesService.getDetails . |
user_ratings_total optional |
Jenis:
number optional Jumlah penilaian pengguna yang berkontribusi pada PlaceResult.rating Tempat ini. |
|
Jenis:
number optional Offset dari UTC zona waktu Place saat ini, dalam menit. Misalnya, Sydney, Australia dengan waktu musim panas 11 jam lebih cepat dari UTC, sehingga utc_offset akan menjadi 660 . Untuk zona waktu di belakang UTC, perbedaannya adalah negatif. Misalnya, utc_offset adalah -60 untuk Tanjung Verde. Hanya tersedia dengan PlacesService.getDetails . |
utc_offset_minutes optional |
Jenis:
number optional Offset dari UTC zona waktu Place saat ini, dalam menit. Misalnya, Sydney, Australia dengan waktu musim panas 11 jam lebih cepat dari UTC, sehingga utc_offset_minutes akan menjadi 660 . Untuk zona waktu di belakang UTC, perbedaannya adalah negatif. Misalnya, utc_offset_minutes adalah -60 untuk Tanjung Verde. Hanya tersedia dengan PlacesService.getDetails . |
vicinity optional |
Jenis:
string optional Alamat yang disederhanakan untuk Tempat, termasuk nama jalan, nomor rumah, dan lokalitas, namun bukan provinsi/negara bagian, kode pos, atau negara. Misalnya, kantor Google di Sydney, Australia memiliki nilai sekitar "48 Pirrama Road, Pyrmont" . Hanya tersedia dengan PlacesService.getDetails . |
website optional |
Jenis:
string optional Situs resmi untuk Tempat ini, seperti halaman beranda bisnis. Hanya tersedia dengan PlacesService.getDetails . |
Antarmuka PlaceAspectRating
Antarmuka google.maps.places.PlaceAspectRating
Menentukan informasi tentang aspek tempat yang telah diulas pengguna.
Properti | |
---|---|
rating |
Jenis:
number Rating dari aspek ini. Untuk masing-masing ulasan, ini adalah bilangan bulat dari 0 hingga 3. Untuk rating gabungan suatu tempat, ini adalah bilangan bulat dari 0 hingga 30. |
type |
Jenis:
string Jenis aspek. Misalnya, "food" , "decor" , "service" , atau "overall" . |
Konstanta BusinessStatus
Konstanta google.maps.places.BusinessStatus
Status operasional Tempat, jika berupa bisnis, dikembalikan di PlaceResult (menunjukkan apakah tempat tersebut beroperasi, atau tutup untuk sementara atau permanen). Tentukan API ini menurut nilai, atau nama konstanta (contoh: 'OPERATIONAL'
atau google.maps.places.BusinessStatus.OPERATIONAL
).
Muat menggunakan parameter URL &libraries=places
. Lihat Library di Maps JavaScript API.
Saat menggunakan v=beta
, dapat diakses dengan memanggil const {BusinessStatus} = await google.map.importLibrary("places")
. Lihat Library di Maps JavaScript API.
Konstanta | |
---|---|
CLOSED_PERMANENTLY |
Bisnis tutup permanen. |
CLOSED_TEMPORARILY |
Bisnis tutup sementara. |
OPERATIONAL |
Bisnis beroperasi secara normal. |
Antarmuka PlaceGeometry
Antarmuka google.maps.places.PlaceGeometry
Mendefinisikan informasi tentang geometri suatu Tempat.
Properti | |
---|---|
location optional |
Jenis:
LatLng optional Posisi Tempat. |
viewport optional |
Jenis:
LatLngBounds optional Area pandang yang diinginkan saat menampilkan Tempat ini di peta. Properti ini akan menjadi null jika area pandang pilihan untuk Tempat tidak diketahui. Hanya tersedia dengan PlacesService.getDetails . |
Antarmuka PlaceOpeningHours
Antarmuka google.maps.places.PlaceOpeningHours
Menentukan informasi tentang jam buka Tempat.
Properti | |
---|---|
|
Jenis:
boolean optional Apakah Tempat buka pada saat ini. |
periods optional |
Jenis:
Array<PlaceOpeningHoursPeriod> optional Periode buka yang mencakup setiap hari dalam seminggu, mulai dari hari Minggu, dalam urutan kronologis. Hari saat Tempat tidak buka tidak disertakan. Hanya tersedia dengan PlacesService.getDetails . |
weekday_text optional |
Jenis:
Array<string> optional Array berisi tujuh string yang menyatakan jam buka yang telah diformat untuk setiap hari dalam seminggu. Layanan Tempat akan memformat dan melokalkan jam buka secara tepat untuk bahasa saat ini. Urutan elemen dalam array ini bergantung pada bahasa. Beberapa bahasa memulai pekan pada hari Senin sementara yang lain mulai pada hari Minggu. Hanya tersedia dengan PlacesService.getDetails . Panggilan lain mungkin menampilkan array kosong. |
Metode | |
---|---|
isOpen |
isOpen([date]) Parameter:
Nilai Hasil:
boolean|undefined Periksa apakah tempat tersebut buka sekarang (saat tidak ada tanggal yang berlalu), atau pada tanggal tertentu. Jika tempat ini tidak memiliki PlaceResult.utc_offset_minutes atau PlaceOpeningHours.periods , undefined akan ditampilkan (PlaceOpeningHours.periods hanya tersedia melalui PlacesService.getDetails ). Metode ini tidak mempertimbangkan jam luar biasa, seperti jam buka di hari libur,. |
Antarmuka PlaceOpeningHoursPeriod
Antarmuka google.maps.places.PlaceOpeningHoursPeriod
Menentukan informasi terstruktur tentang jam buka Tempat. Catatan: Jika Tempat selalu buka, bagian close
akan hilang dari respons. Klien dapat selalu berpatokan pada kondisi selalu-buka yang direpresentasikan sebagai jangka waktu open
yang berisi day
dengan nilai 0
dan time
dengan nilai "0000"
, serta tanpa close
.
Properti | |
---|---|
open |
Jenis:
PlaceOpeningHoursTime Jam buka untuk Tempat. |
close optional |
Jenis:
PlaceOpeningHoursTime optional Jam tutup Tempat. |
Antarmuka PlaceOpeningHoursTime
Antarmuka google.maps.places.PlaceOpeningHoursTime
Menentukan kapan Tempat terbuka atau tutup.
Properti | |
---|---|
day |
Jenis:
number Hari, sebagai angka dalam rentang [ 0 , 6 ], mulai hari Minggu. Misalnya, 2 berarti Selasa. |
hours |
Jenis:
number Jam PlaceOpeningHoursTime.time sebagai angka, dalam rentang [0 , 23 ]. Ini akan dilaporkan dalam zona waktu Tempat. |
minutes |
Jenis:
number Menit PlaceOpeningHoursTime.time sebagai angka, dalam rentang [0 , 59 ]. Ini akan dilaporkan dalam zona waktu Tempat. |
time |
Jenis:
string Waktu dalam format "hhmm" 24 jam. Nilai berada dalam rentang [ "0000" , "2359" ]. Waktu akan dilaporkan dalam zona waktu Tempat. |
nextDate optional |
Jenis:
number optional Stempel waktu (sebagai milidetik sejak epoch, cocok untuk digunakan dengan new Date() ) yang mewakili kemunculan berikutnya dari PlaceOpeningHoursTime ini. Ini dihitung dari PlaceOpeningHoursTime.day minggu ini, PlaceOpeningHoursTime.time , dan PlaceResult.utc_offset_minutes . Jika PlaceResult.utc_offset_minutes adalah undefined , nextDate akan menjadi undefined . |
Antarmuka PlacePlusCode
Antarmuka google.maps.places.PlacePlusCode
Menentukan Kode Lokasi Terbuka atau "plus Codes" untuk Tempat. Plus Codes dapat digunakan sebagai pengganti alamat di tempat tanpa alamat jelas (jika bangunan tidak diberi nomor atau jalan tidak diberi nama).
Properti | |
---|---|
global_code |
Jenis:
string Plus Codes dengan 1/8000 derajat kali 1/8000 derajat area derajat. Misalnya "8FVC9G8F+5W" . |
compound_code optional |
Jenis:
string optional Plus Codes dengan 1/8000 derajat sebesar 1/8000 derajat luas area tempat empat karakter pertama (kode area) dilepas dan diganti dengan deskripsi lokalitas. Misalnya "9G8F+5W Zurich, Switzerland" . Jika tidak ada lokalitas yang cocok yang dapat ditemukan untuk mempersingkat kode, kolom ini akan dihilangkan. |
Antarmuka Place Photo
Antarmuka google.maps.places.PlacePhoto
Merepresentasikan elemen foto Tempat.
Properti | |
---|---|
height |
Jenis:
number Tinggi foto dalam piksel. |
html_attributions |
Jenis:
Array<string> Teks atribusi yang akan ditampilkan untuk foto ini. |
width |
Jenis:
number Lebar foto dalam piksel. |
Metode | |
---|---|
getUrl |
getUrl([opts]) Parameter:
Nilai Hasil:
string Menampilkan URL gambar yang sesuai dengan opsi yang ditentukan. |
Antarmuka PhotoOptions
Antarmuka google.maps.places.PhotoOptions
Mendefinisikan opsi permintaan foto.
Properti | |
---|---|
maxHeight optional |
Jenis:
number optional Tinggi maksimum dalam piksel dari gambar yang ditampilkan. |
maxWidth optional |
Jenis:
number optional Lebar maksimum piksel gambar yang ditampilkan. |
Antarmuka PlaceReview
Antarmuka google.maps.places.PlaceReview
Merepresentasikan satu ulasan tempat.
Properti | |
---|---|
author_name |
Jenis:
string Nama pengulas. |
language |
Jenis:
string Kode bahasa IETF yang menunjukkan bahasa yang digunakan dalam ulasan ini. Perhatikan bahwa kode ini hanya menyertakan tag bahasa utama tanpa tag sekunder yang menunjukkan negara atau wilayah. Misalnya, semua ulasan dalam bahasa Inggris akan diberi tag sebagai 'en' , bukan 'en-AU' atau 'en-UK'. |
profile_photo_url |
Jenis:
string URL ke gambar profil pelaku. |
relative_time_description |
Jenis:
string String yang diformat baru-baru ini, yang menyatakan waktu peninjauan relatif terhadap waktu saat ini dalam formulir yang sesuai untuk bahasa dan negara. Misalnya, "a month ago" . |
text |
Jenis:
string Teks ulasan. |
time |
Jenis:
number Stempel waktu peninjauan, dinyatakan dalam detik sejak epoch. |
|
Jenis:
Array<PlaceAspectRating> optional Aspek yang diberi rating oleh ulasan. Rating pada skala 0 hingga 3. |
author_url optional |
Jenis:
string optional URL ke profil pengulas. Ini akan menjadi undefined saat profil pengulas tidak tersedia. |
rating optional |
Jenis:
number optional Peringkat ulasan ini, angka antara 1,0 dan 5,0 (inklusif). |