Class PlacesService
Class
google.maps.places.PlacesService
Berisi metode yang terkait dengan penelusuran tempat dan pengambilan detail tentang suatu tempat.
Akses dengan memanggil const {PlacesService} = await google.maps.importLibrary("places")
. Lihat Library di Maps JavaScript API.
Konstruktor | |
---|---|
PlacesService |
PlacesService(attrContainer) Parameter:
Membuat instance PlacesService baru yang merender atribusi di penampung yang ditentukan. |
Metode | |
---|---|
findPlaceFromPhoneNumber |
findPlaceFromPhoneNumber(request, callback) Parameter:
Nilai yang Ditampilkan: Tidak ada
Mengambil daftar tempat berdasarkan nomor telepon. Pada umumnya, hanya akan ada satu item dalam daftar hasil, tetapi jika permintaan bersifat 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 yang Ditampilkan: Tidak ada
Mengambil daftar tempat berdasarkan string kueri. Pada umumnya, hanya akan ada satu item dalam daftar hasil, tetapi jika permintaan bersifat 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 yang Ditampilkan: Tidak ada
Mengambil detail tentang tempat yang diidentifikasi oleh placeId yang diberikan. |
nearbySearch |
nearbySearch(request, callback) Parameter:
Nilai yang Ditampilkan: Tidak ada
Mengambil daftar tempat di dekat lokasi tertentu, berdasarkan kata kunci atau jenis. Lokasi harus selalu ditentukan, baik 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 mengirim 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 yang Ditampilkan: Tidak ada
Mengambil daftar tempat berdasarkan string kueri (misalnya, "pizza di Bandung", atau "toko sepatu di dekat Solo"). Parameter lokasi bersifat opsional; jika lokasi ditentukan, hasil hanya dibiaskan ke hasil di sekitar, bukan dibatasi ke tempat di dalam area. 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 dari 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 ditampilkan dan ditagih (hal ini tidak direkomendasikan untuk deployment produksi). Untuk mengetahui daftar kolom, lihat PlaceResult . Kolom bertingkat dapat ditentukan dengan jalur titik (misalnya, "geometry.location" ). |
language optional |
Jenis:
string optional ID bahasa untuk bahasa yang akan digunakan untuk menampilkan detail. Lihat daftar bahasa yang didukung. |
region optional |
Jenis:
string optional Kode wilayah dari wilayah pengguna. Hal ini dapat memengaruhi foto yang dapat ditampilkan, dan mungkin 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 "The United Kingdom of Great Britain and Northern Ireland"). |
sessionToken optional |
Jenis:
AutocompleteSessionToken optional Referensi unik yang digunakan untuk memaketkan permintaan detail dengan sesi pelengkapan otomatis. |
Antarmuka FindPlaceFromPhoneNumberRequest
Antarmuka
google.maps.places.FindPlaceFromPhoneNumberRequest
Permintaan find place from text search 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 ditampilkan dan ditagih (hal ini tidak direkomendasikan untuk deployment produksi). Untuk mengetahui daftar kolom, lihat PlaceResult . Kolom bertingkat dapat ditentukan dengan jalur titik (misalnya, "geometry.location" ). |
phoneNumber |
Jenis:
string Nomor telepon tempat yang akan dicari. Format 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 menelusuri Tempat. Hasilnya akan dibiaskan terhadap, tetapi tidak terbatas pada, LocationBias yang diberikan. |
Antarmuka FindPlaceFromQueryRequest
Antarmuka
google.maps.places.FindPlaceFromQueryRequest
Permintaan find place from text search 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 ditampilkan dan ditagih (hal ini tidak direkomendasikan untuk deployment produksi). Untuk mengetahui 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 menelusuri Tempat. Hasilnya akan dibiaskan terhadap, tetapi tidak terbatas pada, LocationBias yang diberikan. |
Antarmuka PlaceSearchRequest
Antarmuka
google.maps.places.PlaceSearchRequest
Kueri penelusuran Place yang akan dikirim ke PlacesService
.
Properti | |
---|---|
bounds optional |
Jenis:
LatLngBounds|LatLngBoundsLiteral optional Batas untuk 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 penelusuran Tempat. |
maxPriceLevel optional |
Jenis:
number optional Membatasi hasil hanya ke tempat yang berada pada 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 ke tempat yang berada pada 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 ke tempat yang buka saat ini. |
radius optional |
Jenis:
number optional Jarak dari lokasi tertentu yang digunakan 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 dengan jenis tertentu. Jenis ini diterjemahkan ke dalam bahasa lokal lokasi target permintaan dan digunakan sebagai string kueri. Jika kueri juga disediakan, kueri tersebut akan digabungkan ke string jenis yang dilokalkan. Hasil dari jenis yang berbeda akan dihapus dari respons. Gunakan kolom ini untuk melakukan penelusuran kategoris yang tidak bergantung pada 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 pada hasil yang berada dalam batas ini; 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 Pusat area yang digunakan untuk membiaskan hasil saat menelusuri Tempat. |
query optional |
Jenis:
string optional Istilah kueri permintaan. Misalnya, nama tempat ('Menara Eiffel'), kategori 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 memiringkan 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 "The United Kingdom of Great Britain and Northern Ireland"). |
type optional |
Jenis:
string optional Menelusuri tempat dengan jenis tertentu. Jenis ini diterjemahkan ke dalam bahasa lokal lokasi target permintaan dan digunakan sebagai string kueri. Jika kueri juga disediakan, kueri tersebut akan digabungkan ke string jenis yang dilokalkan. Hasil dari jenis yang berbeda akan dihapus dari respons. Gunakan kolom ini untuk melakukan penelusuran kategoris yang tidak bergantung pada bahasa dan wilayah. Jenis yang valid diberikan di sini. |
Konstanta RankBy
Konstanta
google.maps.places.RankBy
Opsi peringkat untuk PlaceSearchRequest.
Akses dengan memanggil const {RankBy} = await google.maps.importLibrary("places")
. Lihat Library di Maps JavaScript API.
Konstanta | |
---|---|
DISTANCE |
Mengurutkan hasil tempat berdasarkan jarak dari lokasi. |
PROMINENCE |
Peringkat menempatkan hasil berdasarkan keterlihatannya. |
Typedef LocationBias
google.maps.places.LocationBias
typedef
LocationBias mewakili batas atau petunjuk tidak pasti yang akan digunakan saat menelusuri Tempat. Hasil mungkin 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 typedef
google.maps.places.LocationRestriction
typedef
LocationRestriction mewakili batas ketat yang akan digunakan saat menelusuri Tempat.
Konstanta PlacesServiceStatus
Konstanta
google.maps.places.PlacesServiceStatus
Status yang ditampilkan oleh PlacesService
saat penelusurannya selesai. Tentukan ini berdasarkan nilai, atau dengan menggunakan nama konstanta. Misalnya, 'OK'
atau google.maps.places.PlacesServiceStatus.OK
.
Akses dengan memanggil const {PlacesServiceStatus} = await google.maps.importLibrary("places")
. Lihat Library di Maps JavaScript API.
Konstanta | |
---|---|
INVALID_REQUEST |
Permintaan ini tidak valid. |
NOT_FOUND |
Tempat yang dirujuk tidak ditemukan. |
OK |
Respons berisi hasil yang valid. |
OVER_QUERY_LIMIT |
Aplikasi telah melampaui kuota permintaannya. |
REQUEST_DENIED |
Aplikasi tidak diizinkan untuk menggunakan PlacesService . |
UNKNOWN_ERROR |
Permintaan PlacesService tidak dapat diproses karena error server. Permintaan mungkin berhasil jika Anda mencoba lagi. |
ZERO_RESULTS |
Tidak ada hasil yang ditemukan untuk permintaan ini. |
Antarmuka PlaceSearchPagination
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 yang Ditampilkan: Tidak ada
Mengambil halaman hasil berikutnya. Menggunakan fungsi callback yang sama dengan yang diberikan ke 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 diberi rating di Tempat ini, berdasarkan ulasan pengguna Google dan Zagat. Rating menggunakan skala 0 hingga 30. |
business_status optional |
Jenis:
BusinessStatus optional Tanda 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 ini tidak akan ada dalam respons penelusuran atau 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 yang terkait dengan 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 telah diminta, dan harus ditampilkan. |
icon optional |
Jenis:
string optional URL ke resource gambar yang dapat digunakan untuk mewakili 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 yang terpotong ke masker ikon. Akses berbagai jenis ikon dengan menambahkan ekstensi file di bagian akhir (yaitu .svg atau .png ). |
international_phone_number optional |
Jenis:
string optional Nomor telepon Tempat 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: Dalam kasus Tempat yang dimasukkan pengguna, ini adalah teks mentah, seperti yang diketik oleh pengguna. Harap berhati-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 buka atau tutup. |
|
Jenis:
boolean optional Tanda yang menunjukkan apakah Tempat ditutup, baik secara permanen maupun sementara. Jika tempat beroperasi, atau jika tidak ada data yang tersedia, tanda tidak akan ada dalam respons. |
photos optional |
Jenis:
Array<PlacePhoto> optional Foto Tempat ini. Koleksi ini akan berisi hingga sepuluh objek PlacePhoto . |
place_id optional |
Jenis:
string optional ID unik untuk Tempat. |
plus_code optional |
Jenis:
PlacePlusCode optional Menentukan Open Location Codes atau "plus codes" untuk Tempat. |
price_level optional |
Jenis:
number optional Tingkat harga Tempat, dengan skala 0 hingga 4. Tingkat harga ditafsirkan sebagai berikut:
|
rating optional |
Jenis:
number optional Rating, 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. Halaman ini adalah halaman milik Google yang berisi informasi terbaik yang tersedia tentang Tempat. Hanya tersedia dengan PlacesService.getDetails . |
user_ratings_total optional |
Jenis:
number optional Jumlah rating pengguna yang berkontribusi pada PlaceResult.rating Tempat ini. |
|
Jenis:
number optional Offset dari UTC zona waktu Tempat saat ini, dalam menit. Misalnya, Sydney, Australia dalam waktu musim panas 11 jam lebih cepat dari UTC, sehingga utc_offset akan menjadi 660 . Untuk zona waktu yang lebih lambat dari UTC, offset-nya negatif. Misalnya, utc_offset adalah -60 untuk Cape Verde. Hanya tersedia dengan PlacesService.getDetails . |
utc_offset_minutes optional |
Jenis:
number optional Offset dari UTC zona waktu Tempat saat ini, dalam menit. Misalnya, Sydney, Australia dalam waktu musim panas 11 jam lebih cepat dari UTC, sehingga utc_offset_minutes akan menjadi 660 . Untuk zona waktu yang lebih lambat dari UTC, offset-nya negatif. Misalnya, utc_offset_minutes adalah -60 untuk Cape Verde. Hanya tersedia dengan PlacesService.getDetails . |
vicinity optional |
Jenis:
string optional Alamat yang disederhanakan untuk Tempat, termasuk nama jalan, nomor jalan, dan lokalitas, tetapi 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 ditinjau pengguna.
Properti | |
---|---|
rating |
Jenis:
number Rating aspek ini. Untuk ulasan individual, ini adalah bilangan bulat dari 0 hingga 3. Untuk rating gabungan 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, ditampilkan dalam PlaceResult (menunjukkan apakah tempat tersebut beroperasi, atau tutup sementara atau permanen). Tentukan ini berdasarkan nilai, atau nama konstanta (contoh: 'OPERATIONAL'
atau google.maps.places.BusinessStatus.OPERATIONAL
).
Akses dengan memanggil const {BusinessStatus} = await google.maps.importLibrary("places")
. Lihat Library di Maps JavaScript API.
Konstanta | |
---|---|
CLOSED_PERMANENTLY |
Bisnis ini tutup permanen. |
CLOSED_TEMPORARILY |
Bisnis tutup sementara. |
OPERATIONAL |
Bisnis beroperasi secara normal. |
Antarmuka PlaceGeometry
Antarmuka
google.maps.places.PlaceGeometry
Menentukan informasi tentang geometri 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 yang diinginkan 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 mewakili jam buka yang telah diformat untuk setiap hari dalam seminggu. Places Service 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 (jika tidak ada tanggal yang diteruskan), atau pada tanggal yang ditentukan. 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 buka khusus, seperti jam buka pada 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 mengandalkan selalu-buka yang direpresentasikan sebagai jangka waktu open
yang berisi day
dengan nilai 0
dan time
dengan nilai "0000"
, dan tanpa close
.
Properti | |
---|---|
open |
Jenis:
PlaceOpeningHoursTime Waktu buka Tempat. |
close optional |
Jenis:
PlaceOpeningHoursTime optional Waktu tutup untuk Tempat. |
Antarmuka PlaceOpeningHoursTime
Antarmuka
google.maps.places.PlaceOpeningHoursTime
Menentukan kapan Tempat buka atau tutup.
Properti | |
---|---|
day |
Jenis:
number Hari dalam seminggu, sebagai angka dalam rentang [ 0 , 6 ], dimulai pada 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. Nilai ini dihitung dari PlaceOpeningHoursTime.day minggu, 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 Open Location Codes 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 area 1/8000 derajat x 1/8000 derajat. Misalnya, "8FVC9G8F+5W" . |
compound_code optional |
Jenis:
string optional Plus Codes dengan area 1/8000 derajat kali 1/8000 derajat yang empat karakter pertamanya (kode area) dihapus dan diganti dengan deskripsi lokalitas. Misalnya, "9G8F+5W Zurich, Switzerland" . Jika tidak ada lokalitas yang sesuai yang dapat ditemukan untuk mempersingkat kode, kolom ini akan dihilangkan. |
Antarmuka PlacePhoto
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
Menentukan opsi permintaan foto.
Properti | |
---|---|
maxHeight optional |
Jenis:
number optional Tinggi maksimum dalam piksel dari gambar yang ditampilkan. |
maxWidth optional |
Jenis:
number optional Lebar maksimum dalam piksel dari gambar yang ditampilkan. |
Antarmuka PlaceReview
Antarmuka
google.maps.places.PlaceReview
Merepresentasikan satu ulasan tentang suatu tempat.
Properti | |
---|---|
author_name |
Jenis:
string Nama pengulas. |
language |
Jenis:
string Kode bahasa IETF yang menunjukkan bahasa yang digunakan untuk menulis 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 'en' , bukan 'en-AU' atau 'en-UK'. |
profile_photo_url |
Jenis:
string URL ke gambar profil peninjau. |
relative_time_description |
Jenis:
string String waktu terbaru yang diformat, yang menyatakan waktu peninjauan relatif terhadap waktu saat ini dalam bentuk yang sesuai untuk bahasa dan negara. Misalnya, "a month ago" . |
text |
Jenis:
string Teks ulasan. |
time |
Jenis:
number Stempel waktu untuk ulasan, dinyatakan dalam detik sejak epoch. |
|
Jenis:
Array<PlaceAspectRating> optional Aspek yang diberi rating oleh ulasan. Rating dalam skala 0 hingga 3. |
author_url optional |
Jenis:
string optional URL ke profil pengulas. Nilai ini akan menjadi undefined jika profil peninjau tidak tersedia. |
rating optional |
Jenis:
number optional Rating ulasan ini, berupa angka antara 1,0 dan 5,0 (inklusif). |