Class PlacesService
class
google.maps.places.PlacesService
library "places"
Berisi metode yang terkait dengan penelusuran tempat dan pengambilan detail tentang suatu tempat.
const {PlacesService} = await google.maps.importLibrary("places");
Konstruktor | |
|---|---|
PlacesService |
PlacesService(attrContainer)Parameter:
Membuat instance baru PlacesService yang merender atribusi dalam penampung yang ditentukan. |
Metode | |
|---|---|
findPlaceFromPhoneNumber |
findPlaceFromPhoneNumber(request, callback)Parameter:
Nilai Hasil: Tidak ada
Mengambil daftar tempat berdasarkan nomor telepon. Biasanya, hanya 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 Hasil: Tidak ada
Mengambil daftar tempat berdasarkan string kueri. Biasanya, hanya 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 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, 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 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 di Bandung", atau "toko sepatu di dekat Solo"). Parameter lokasi bersifat opsional; jika lokasi ditentukan, hasil hanya akan dicondongkan ke hasil di sekitar, bukan dibatasi ke 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:
stringID Tempat untuk Tempat yang detailnya diminta. |
fields
opsional |
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
opsional |
Jenis:
string optionalID bahasa untuk bahasa yang akan digunakan untuk menampilkan detail. Lihat daftar bahasa yang didukung. |
region
opsional |
Jenis:
string optionalKode wilayah dari wilayah pengguna. Hal ini dapat memengaruhi foto yang mungkin 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
opsional |
Jenis:
AutocompleteSessionToken optionalReferensi unik yang digunakan untuk menggabungkan 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 berupa E.164. |
language
opsional |
Jenis:
string optionalID bahasa untuk bahasa yang harus digunakan untuk menampilkan nama dan alamat, jika memungkinkan. Lihat daftar bahasa yang didukung. |
locationBias
opsional |
Jenis:
LocationBias optionalBias yang digunakan saat menelusuri Tempat. Hasilnya akan dicondongkan ke, 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
opsional |
Jenis:
string optionalID bahasa untuk bahasa yang harus digunakan untuk menampilkan nama dan alamat, jika memungkinkan. Lihat daftar bahasa yang didukung. |
locationBias
opsional |
Jenis:
LocationBias optionalBias yang digunakan saat menelusuri Tempat. Hasilnya akan dicondongkan ke, tetapi tidak terbatas pada, LocationBias yang diberikan. |
Antarmuka PlaceSearchRequest
antarmuka
google.maps.places.PlaceSearchRequest
Kueri penelusuran Place Search yang akan dikirim ke PlacesService.
Properti | |
|---|---|
bounds
opsional |
Jenis:
LatLngBounds|LatLngBoundsLiteral optionalBatas tempat untuk menelusuri Tempat. location dan radius akan diabaikan jika bounds ditetapkan. |
keyword
opsional |
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
opsional |
Jenis:
string optionalID bahasa untuk bahasa yang harus digunakan untuk menampilkan nama dan alamat, jika memungkinkan. Lihat daftar bahasa yang didukung. |
location
opsional |
Jenis:
LatLng|LatLngLiteral optionalLokasi di sekitar tempat yang akan ditelusuri. |
maxPriceLevel
opsional |
Jenis:
number optionalMembatasi hasil hanya ke tempat yang berada dalam 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
opsional |
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 kurang dari atau sama dengan maxPrice, jika ditentukan. |
opsional |
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
opsional |
Jenis:
boolean optionalMembatasi hasil hanya ke tempat yang buka saat ini. |
radius
opsional |
Jenis:
number optionalJarak dari lokasi yang ditentukan untuk menelusuri Tempat, dalam meter. Nilai maksimum yang diizinkan adalah 50.000. |
rankBy
opsional |
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
opsional |
Jenis:
string optionalMenelusuri tempat dengan jenis yang ditentukan. Jenis ini diterjemahkan ke bahasa lokal lokasi target permintaan dan digunakan sebagai string kueri. Jika kueri juga diberikan, 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
opsional |
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 di dalam batas ini, tetapi hasil di dalamnya akan memiliki peringkat lebih tinggi. |
language
opsional |
Jenis:
string optionalID bahasa untuk bahasa yang harus digunakan untuk menampilkan nama dan alamat, jika memungkinkan. Lihat daftar bahasa yang didukung. |
location
opsional |
Jenis:
LatLng|LatLngLiteral optionalPusat area yang digunakan untuk membiaskan hasil saat menelusuri Tempat. |
query
opsional |
Jenis:
string optionalIstilah kueri permintaan. Misalnya, nama tempat ('Menara Eiffel'), kategori yang diikuti dengan nama lokasi ('pizza di New York'), atau nama tempat yang diikuti dengan pembeda lokasi ('Starbucks di Sydney'). |
radius
opsional |
Jenis:
number optionalRadius area yang digunakan untuk membiaskan hasil saat menelusuri Tempat, dalam meter. |
region
opsional |
Jenis:
string optionalKode 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 "The United Kingdom of Great Britain and Northern Ireland"). |
type
opsional |
Jenis:
string optionalMenelusuri tempat dengan jenis yang ditentukan. Jenis ini diterjemahkan ke bahasa lokal lokasi target permintaan dan digunakan sebagai string kueri. Jika kueri juga diberikan, 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
google.maps.places.RankBy
library "places"
Opsi penentuan peringkat untuk PlaceSearchRequest.
const {RankBy} = await google.maps.importLibrary("places");
Konstanta | |
|---|---|
DISTANCE |
Memberi peringkat hasil tempat berdasarkan jarak dari lokasi. |
PROMINENCE |
Memberi peringkat hasil tempat berdasarkan keterlihatannya. |
typedef LocationBias
typedef
google.maps.places.LocationBias
LocationBias mewakili batas atau petunjuk fleksibel 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|LatLngAltitude|LatLngAltitudeLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
typedef LocationRestriction
typedef
google.maps.places.LocationRestriction
LocationRestriction mewakili batas ketat yang akan digunakan saat menelusuri Tempat.
PlacesServiceStatus
google.maps.places.PlacesServiceStatus
library "places"
Status yang ditampilkan oleh PlacesService setelah penelusurannya selesai. Tentukan ini berdasarkan nilai, atau dengan menggunakan nama konstanta. Misalnya, 'OK' atau google.maps.places.PlacesServiceStatus.OK.
Konstanta ini juga dapat digunakan sebagai string. Di TypeScript, literal string ditentukan oleh jenis PlacesServiceStatusString.
const {PlacesServiceStatus} = await google.maps.importLibrary("places");
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 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 tersedia hasil lebih lanjut. 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
opsional |
Jenis:
Array<GeocoderAddressComponent> optionalKumpulan komponen alamat untuk lokasi Tempat ini. Hanya tersedia dengan PlacesService.getDetails. |
adr_address
opsional |
Jenis:
string optionalRepresentasi alamat Tempat dalam mikroformat adr. Hanya tersedia dengan PlacesService.getDetails. |
aspects
opsional |
Jenis:
Array<Aspek yang diberi rating dari Tempat ini, berdasarkan ulasan pengguna Google dan Zagat. Rating menggunakan skala 0 hingga 30. |
business_status
opsional |
Jenis:
BusinessStatus optionalFlag 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 ada dalam respons penelusuran atau detail. |
formatted_address
opsional |
Jenis:
string optionalAlamat lengkap Tempat. |
formatted_phone_number
opsional |
Jenis:
string optionalNomor telepon Tempat, yang diformat sesuai dengan konvensi penomoran di wilayah tersebut. Hanya tersedia dengan PlacesService.getDetails. |
geometry
opsional |
Jenis:
PlaceGeometry optionalInformasi yang terkait dengan geometri Tempat. |
html_attributions
opsional |
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
opsional |
Jenis:
string optionalURL ke resource gambar yang dapat digunakan untuk menampilkan kategori Tempat ini. |
icon_background_color
opsional |
Jenis:
string optionalWarna latar belakang untuk digunakan dengan ikon Tempat. Lihat juga PlaceResult.icon_mask_base_uri. |
icon_mask_base_uri
opsional |
Jenis:
string optionalURL yang dipotong ke mask ikon. Akses berbagai jenis ikon dengan menambahkan ekstensi file di akhir (misalnya, .svg atau .png). |
international_phone_number
opsional |
Jenis:
string optionalNomor telepon Tempat dalam format internasional. Format internasional menyertakan kode negara dan diawali dengan tanda tambah (+). Hanya tersedia dengan PlacesService.getDetails. |
name
opsional |
Jenis:
string optionalNama Tempat. Catatan: Untuk 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
opsional |
Jenis:
PlaceOpeningHours optionalMenentukan kapan Tempat buka atau tutup. |
opsional |
Jenis:
boolean optionalFlag yang menunjukkan apakah Tempat ditutup, baik secara permanen maupun sementara. Jika tempat tersebut beroperasi, atau jika tidak ada data yang tersedia, tanda tersebut tidak ada dalam respons. |
photos
opsional |
Jenis:
Array<PlacePhoto> optionalFoto Tempat ini. Koleksi ini akan berisi hingga sepuluh objek PlacePhoto. |
place_id
opsional |
Jenis:
string optionalID unik untuk Tempat. |
plus_code
opsional |
Jenis:
PlacePlusCode optionalMenentukan Open Location Code atau "plus codes" untuk Tempat. |
price_level
opsional |
Jenis:
number optionalTingkat harga Tempat, dalam skala 0 hingga 4. Tingkat harga ditafsirkan sebagai berikut:
|
rating
opsional |
Jenis:
number optionalRating, antara 1,0 hingga 5,0, berdasarkan ulasan pengguna untuk Tempat ini. |
reviews
opsional |
Jenis:
Array<PlaceReview> optionalDaftar ulasan untuk Tempat ini. Hanya tersedia dengan PlacesService.getDetails. |
types
opsional |
Jenis:
Array<string> optionalArray jenis untuk Tempat ini (misalnya, ["political", "locality"] atau ["restaurant", "establishment"]). |
url
opsional |
Jenis:
string optionalURL laman resmi Google untuk tempat ini. Halaman ini adalah halaman milik Google berisi informasi terbaik yang tersedia tentang Tempat ini. Hanya tersedia dengan PlacesService.getDetails. |
user_ratings_total
opsional |
Jenis:
number optionalJumlah rating pengguna yang berkontribusi pada PlaceResult.rating Tempat ini. |
opsional |
Jenis:
number optionalOffset dari UTC untuk zona waktu Tempat saat ini, dalam menit. Misalnya, Sydney, Australia dalam waktu musim panas adalah 11 jam lebih awal dari UTC, sehingga utc_offset akan menjadi 660. Untuk zona waktu yang lebih lambat dari UTC, selisihnya negatif. Misalnya, utc_offset adalah -60 untuk Tanjung Verde. Hanya tersedia dengan PlacesService.getDetails. |
utc_offset_minutes
opsional |
Jenis:
number optionalOffset dari UTC untuk zona waktu Tempat saat ini, dalam menit. Misalnya, Sydney, Australia dalam waktu musim panas adalah 11 jam lebih awal dari UTC, sehingga utc_offset_minutes akan menjadi 660. Untuk zona waktu yang lebih lambat dari UTC, selisihnya negatif. Misalnya, utc_offset_minutes adalah -60 untuk Tanjung Verde. Hanya tersedia dengan PlacesService.getDetails. |
vicinity
opsional |
Jenis:
string optionalAlamat yang disederhanakan untuk Tempat, termasuk nama jalan, nomor gedung, dan lokalitas, tetapi bukan provinsi/negara bagian, kode pos, atau negara. Misalnya, kantor Google di Sydney, Australia memiliki nilai vicinity berupa "48 Pirrama Road, Pyrmont". Hanya tersedia dengan PlacesService.getDetails. |
website
opsional |
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 diulas pengguna.
Properti | |
|---|---|
rating |
Jenis:
numberRating aspek ini. Untuk ulasan individual, ini adalah bilangan bulat dari 0 hingga 3. Untuk rating gabungan suatu tempat, ini adalah bilangan bulat dari 0 hingga 30. |
type |
Jenis:
stringJenis aspek. Misalnya, "food", "decor", "service", atau "overall". |
BusinessStatus konstanta
google.maps.places.BusinessStatus
library "places"
Status bisnis untuk tempat tersebut. Lihat dokumentasi layanan web untuk mengetahui informasi selengkapnya.
Konstanta ini juga dapat digunakan sebagai string. Di TypeScript, literal string ditentukan oleh jenis BusinessStatusString.
const {BusinessStatus} = await google.maps.importLibrary("places");
Konstanta | |
|---|---|
CLOSED_PERMANENTLY |
Tempat usaha tutup permanen. Lihat dokumentasi layanan web untuk mengetahui informasi selengkapnya. |
CLOSED_TEMPORARILY |
Tempat usaha tutup sementara. Lihat dokumentasi layanan web untuk mengetahui informasi selengkapnya. |
FUTURE_OPENING |
Tempat usaha akan dibuka pada masa mendatang. Lihat dokumentasi layanan web untuk mengetahui informasi selengkapnya. |
OPERATIONAL |
Tempat usaha tersebut beroperasi, tetapi tidak harus buka sekarang. Lihat dokumentasi layanan web untuk mengetahui informasi selengkapnya. |
Antarmuka PlaceGeometry
antarmuka
google.maps.places.PlaceGeometry
Menentukan informasi tentang geometri Tempat.
Properti | |
|---|---|
location
opsional |
Jenis:
LatLng optionalPosisi Tempat. |
viewport
opsional |
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 suatu Tempat.
Properti | |
|---|---|
opsional |
Jenis:
boolean optionalApakah Tempat buka pada waktu saat ini. |
periods
opsional |
Jenis:
Array<PlaceOpeningHoursPeriod> optionalJangka waktu buka yang mencakup setiap hari dalam seminggu, mulai dari hari Minggu, dalam urutan kronologis. Hari saat Tempat tutup tidak disertakan. Hanya tersedia dengan PlacesService.getDetails. |
weekday_text
opsional |
Jenis:
Array<string> optionalArray berisi tujuh string yang menyatakan jam buka yang telah diformat untuk setiap hari dalam seminggu. Layanan Places 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|undefinedMemeriksa 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 hari libur. |
Antarmuka PlaceOpeningHoursPeriod
antarmuka
google.maps.places.PlaceOpeningHoursPeriod
Menentukan informasi terstruktur tentang jam buka suatu 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", dan tanpa close.
Properti | |
|---|---|
open |
Jenis:
PlaceOpeningHoursTimeWaktu buka Tempat. |
close
opsional |
Jenis:
PlaceOpeningHoursTime optionalWaktu tutup 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]. Jam ini akan dilaporkan dalam zona waktu Tempat. |
minutes |
Jenis:
numberMenit PlaceOpeningHoursTime.time sebagai angka, dalam rentang [0, 59]. Nilai ini akan dilaporkan dalam zona waktu Tempat. |
time |
Jenis:
stringWaktu dalam format 24 jam "jjmm". Nilai berada dalam rentang [ "0000", "2359"]. Waktu akan dilaporkan dalam zona waktu Tempat. |
nextDate
opsional |
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 Code 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
opsional |
Jenis:
string optionalPlus code dengan area 1/8000 derajat kali 1/8000 derajat, dengan empat karakter pertama (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
opsional |
Jenis:
number optionalTinggi maksimum dalam piksel dari gambar yang ditampilkan. |
maxWidth
opsional |
Jenis:
number optionalLebar maksimum dalam piksel untuk gambar yang ditampilkan. |
Antarmuka PlaceReview
antarmuka
google.maps.places.PlaceReview
Merepresentasikan satu ulasan tempat.
Properti | |
|---|---|
author_name |
Jenis:
stringNama pengulas. |
language |
Jenis:
stringKode 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 'en', bukan 'en-AU' atau 'en-UK'. |
profile_photo_url |
Jenis:
stringURL ke gambar profil pengulas. |
relative_time_description |
Jenis:
stringString waktu terbaru yang diformat, yang menyatakan waktu ulasan 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, yang dinyatakan dalam detik sejak epoch. |
opsional |
Jenis:
Array<Aspek yang diberi rating oleh ulasan. Rating dalam skala 0 hingga 3. |
author_url
opsional |
Jenis:
string optionalURL ke profil pengulas. Ini akan menjadi undefined jika profil pengulas tidak tersedia. |
rating
opsional |
Jenis:
number optionalRating ulasan ini, angka antara 1,0 dan 5,0 (inklusif). |