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:
stringID Tempat dari Tempat yang detailnya diminta. |
fields optional |
Jenis:
Array<string> optionalKolom 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 optionalID bahasa untuk bahasa yang akan digunakan untuk menampilkan detail. Lihat daftar bahasa yang didukung. |
region optional |
Jenis:
string optionalKode 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 optionalReferensi 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:
stringNomor telepon tempat yang akan dicari. Format harus E.164. |
language optional |
Jenis:
string optionalID bahasa untuk bahasa yang digunakan untuk menampilkan nama dan alamat, jika memungkinkan. Lihat daftar bahasa yang didukung. |
locationBias optional |
Jenis:
LocationBias optionalBias 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:
stringKueri permintaan. Misalnya, nama atau alamat tempat. |
language optional |
Jenis:
string optionalID bahasa untuk bahasa yang digunakan untuk menampilkan nama dan alamat, jika memungkinkan. Lihat daftar bahasa yang didukung. |
locationBias optional |
Jenis:
LocationBias optionalBias 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 optionalBatas untuk menelusuri Tempat. location dan radius akan diabaikan jika bounds ditetapkan. |
keyword optional |
Jenis:
string optionalIstilah 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 optionalID bahasa untuk bahasa yang digunakan untuk menampilkan nama dan alamat, jika memungkinkan. Lihat daftar bahasa yang didukung. |
location optional |
Jenis:
LatLng|LatLngLiteral optionalLokasi sekitar untuk penelusuran Tempat. |
maxPriceLevel optional |
Jenis:
number optionalMembatasi 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 optionalMembatasi 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 optionalSetara 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 optionalMembatasi hasil hanya ke tempat yang buka saat ini. |
radius optional |
Jenis:
number optionalJarak dari lokasi tertentu yang digunakan untuk menelusuri Tempat, dalam meter. Nilai maksimum yang diizinkan adalah 50.000. |
rankBy optional |
Jenis:
RankBy optionalDefault:
RankBy.PROMINENCEMenentukan 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 optionalMenelusuri 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 optionalBatas 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 optionalID bahasa untuk bahasa yang digunakan untuk menampilkan nama dan alamat, jika memungkinkan. Lihat daftar bahasa yang didukung. |
location optional |
Jenis:
LatLng|LatLngLiteral optionalPusat area yang digunakan untuk membiaskan hasil saat menelusuri Tempat. |
query optional |
Jenis:
string optionalIstilah 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 optionalRadius area yang digunakan untuk membiaskan hasil saat menelusuri Tempat, dalam meter. |
region optional |
Jenis:
string optionalKode 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 optionalMenelusuri 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:
booleanMenunjukkan apakah hasil lebih lanjut tersedia. true saat ada halaman hasil tambahan. |
Metode | |
|---|---|
nextPage |
nextPage()Parameter: Tidak ada
Nilai Hasil:
voidMengambil 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> optionalKumpulan komponen alamat untuk lokasi Tempat ini. Hanya tersedia dengan PlacesService.getDetails. |
adr_address optional |
Jenis:
string optionalRepresentasi alamat Tempat dalam microformat adr. Hanya tersedia dengan PlacesService.getDetails. |
aspects optional |
Jenis:
Array<PlaceAspectRating> optionalAspek yang diberi rating di Tempat ini, berdasarkan ulasan pengguna Google dan Zagat. Rating menggunakan skala 0 hingga 30. |
business_status optional |
Jenis:
BusinessStatus optionalTanda 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 optionalAlamat lengkap Tempat. |
formatted_phone_number optional |
Jenis:
string optionalNomor telepon Tempat, yang diformat sesuai dengan konvensi regional nomor. Hanya tersedia dengan PlacesService.getDetails. |
geometry optional |
Jenis:
PlaceGeometry optionalInformasi yang terkait dengan geometri Tempat. |
html_attributions optional |
Jenis:
Array<string> optionalTeks 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 optionalURL ke resource gambar yang dapat digunakan untuk mewakili kategori Tempat ini. |
icon_background_color optional |
Jenis:
string optionalWarna latar belakang untuk digunakan dengan ikon Tempat. Lihat juga PlaceResult.icon_mask_base_uri. |
icon_mask_base_uri optional |
Jenis:
string optionalURL 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 optionalNomor telepon Tempat dalam format internasional. Format internasional menyertakan kode negara dan diawali dengan tanda tambah (+). Hanya tersedia dengan PlacesService.getDetails. |
name optional |
Jenis:
string optionalNama 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 optionalMenentukan kapan Tempat buka atau tutup. |
|
Jenis:
boolean optionalTanda 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> optionalFoto Tempat ini. Koleksi ini akan berisi hingga sepuluh objek PlacePhoto. |
place_id optional |
Jenis:
string optionalID unik untuk Tempat. |
plus_code optional |
Jenis:
PlacePlusCode optionalMenentukan Open Location Codes atau "plus codes" untuk Tempat. |
price_level optional |
Jenis:
number optionalTingkat harga Tempat, dengan skala 0 hingga 4. Tingkat harga ditafsirkan sebagai berikut:
|
rating optional |
Jenis:
number optionalRating, antara 1,0 hingga 5,0, berdasarkan ulasan pengguna tentang Tempat ini. |
reviews optional |
Jenis:
Array<PlaceReview> optionalDaftar ulasan Tempat ini. Hanya tersedia dengan PlacesService.getDetails. |
types optional |
Jenis:
Array<string> optionalArray jenis untuk Tempat ini (misalnya, ["political", "locality"] atau ["restaurant", "establishment"]). |
url optional |
Jenis:
string optionalURL 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 optionalJumlah rating pengguna yang berkontribusi pada PlaceResult.rating Tempat ini. |
|
Jenis:
number optionalOffset 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 optionalOffset 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 optionalAlamat 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 optionalSitus 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:
numberRating 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:
stringJenis 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 optionalPosisi Tempat. |
viewport optional |
Jenis:
LatLngBounds optionalArea 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 optionalApakah Tempat buka pada saat ini. |
periods optional |
Jenis:
Array<PlaceOpeningHoursPeriod> optionalPeriode 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> optionalArray 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|undefinedPeriksa 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:
PlaceOpeningHoursTimeWaktu buka Tempat. |
close optional |
Jenis:
PlaceOpeningHoursTime optionalWaktu tutup untuk Tempat. |
Antarmuka PlaceOpeningHoursTime
Antarmuka
google.maps.places.PlaceOpeningHoursTime
Menentukan kapan Tempat buka atau tutup.
Properti | |
|---|---|
day |
Jenis:
numberHari dalam seminggu, sebagai angka dalam rentang [ 0, 6], dimulai pada hari Minggu. Misalnya, 2 berarti Selasa. |
hours |
Jenis:
numberJam PlaceOpeningHoursTime.time sebagai angka, dalam rentang [0, 23]. Ini akan dilaporkan dalam zona waktu Tempat. |
minutes |
Jenis:
numberMenit PlaceOpeningHoursTime.time sebagai angka, dalam rentang [0, 59]. Ini akan dilaporkan dalam zona waktu Tempat. |
time |
Jenis:
stringWaktu dalam format "hhmm" 24 jam. Nilai berada dalam rentang [ "0000", "2359"]. Waktu akan dilaporkan dalam zona waktu Tempat. |
nextDate optional |
Jenis:
number optionalStempel 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:
stringPlus Codes dengan area 1/8000 derajat x 1/8000 derajat. Misalnya, "8FVC9G8F+5W". |
compound_code optional |
Jenis:
string optionalPlus 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:
numberTinggi foto dalam piksel. |
html_attributions |
Jenis:
Array<string>Teks atribusi yang akan ditampilkan untuk foto ini. |
width |
Jenis:
numberLebar foto dalam piksel. |
Metode | |
|---|---|
getUrl |
getUrl([opts])Parameter:
Nilai Hasil:
stringMenampilkan URL gambar yang sesuai dengan opsi yang ditentukan. |
Antarmuka PhotoOptions
Antarmuka
google.maps.places.PhotoOptions
Menentukan opsi permintaan foto.
Properti | |
|---|---|
maxHeight optional |
Jenis:
number optionalTinggi maksimum dalam piksel dari gambar yang ditampilkan. |
maxWidth optional |
Jenis:
number optionalLebar maksimum dalam piksel dari gambar yang ditampilkan. |
Antarmuka PlaceReview
Antarmuka
google.maps.places.PlaceReview
Merepresentasikan satu ulasan tentang suatu tempat.
Properti | |
|---|---|
author_name |
Jenis:
stringNama pengulas. |
language |
Jenis:
stringKode 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:
stringURL ke gambar profil peninjau. |
relative_time_description |
Jenis:
stringString 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:
stringTeks ulasan. |
time |
Jenis:
numberStempel waktu untuk ulasan, dinyatakan dalam detik sejak epoch. |
|
Jenis:
Array<PlaceAspectRating> optionalAspek yang diberi rating oleh ulasan. Rating dalam skala 0 hingga 3. |
author_url optional |
Jenis:
string optionalURL ke profil pengulas. Nilai ini akan menjadi undefined jika profil peninjau tidak tersedia. |
rating optional |
Jenis:
number optionalRating ulasan ini, berupa angka antara 1,0 dan 5,0 (inklusif). |