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 dalam container yang ditentukan. |
Metode | |
---|---|
findPlaceFromPhoneNumber |
findPlaceFromPhoneNumber(request, callback) Parameter:
Nilai Hasil: Tidak ada
Mengambil daftar tempat berdasarkan nomor telepon. Pada umumnya, seharusnya 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. Pada umumnya, seharusnya 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 tertentu. |
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 terdekat, bukan dibatasi pada tempat di dalam area. Gunakan textSearch jika Anda ingin menelusuri tempat menggunakan string arbitrer, dan jika Anda 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 detail akan diminta. |
fields optional |
Jenis:
Array<string> optional Kolom yang akan disertakan dalam respons detail, yang akan ditagihkan. 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 titik-jalur (misalnya, "geometry.location" ). |
language optional |
Jenis:
string optional ID bahasa untuk bahasa yang digunakan untuk menampilkan detail. Lihat daftar bahasa yang didukung. |
region optional |
Jenis:
string optional Kode wilayah untuk region pengguna. Hal ini dapat memengaruhi foto mana yang dapat dikembalikan, dan mungkin hal-hal lainnya. Kode wilayah menerima nilai yang berisi dua karakter ccTLD ("top-level domain"). 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 memaketkan permintaan detail dengan sesi pelengkapan otomatis. |
Antarmuka FindPlaceFromPhoneNumberRequest
Antarmuka
google.maps.places.FindPlaceFromPhoneNumberRequest
Temukan tempat dari permintaan penelusuran teks yang akan dikirim ke PlacesService.findPlaceFromPhoneNumber
.
Properti | |
---|---|
fields |
Jenis:
Array<string> Kolom yang akan disertakan dalam respons, yang akan ditagihkan. 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 titik-jalur (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
Temukan tempat dari permintaan penelusuran teks yang akan dikirim ke PlacesService.findPlaceFromQuery
.
Properti | |
---|---|
fields |
Jenis:
Array<string> Kolom yang akan disertakan dalam respons, yang akan ditagihkan. 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 titik-jalur (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 Tempat yang akan dikirim ke PlacesService
.
Properti | |
---|---|
bounds optional |
Jenis:
LatLngBounds|LatLngBoundsLiteral optional Batas yang akan digunakan 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 yang digunakan untuk menelusuri Tempat. |
maxPriceLevel optional |
Jenis:
number optional Membatasi hasil hanya ke tempat 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 ke tempat dengan tingkat harga yang ditentukan atau yang lebih tinggi. Nilai yang valid berkisar dari 0 (paling terjangkau) hingga 4 (paling mahal), inklusif. Harus lebih kecil 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 sedang buka. |
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 pemberian peringkat yang akan digunakan saat menampilkan hasil. Perhatikan bahwa jika rankBy disetel 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 ini diterjemahkan ke dalam bahasa lokal lokasi target permintaan dan digunakan sebagai string kueri. Jika disediakan, kueri akan disambungkan ke string jenis yang dilokalkan. Hasil dari jenis yang berbeda akan dihapus dari respons. Gunakan kolom ini untuk melakukan penelusuran kategori 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 mencondongkan hasil saat menelusuri Tempat (opsional). location dan radius akan diabaikan jika bounds ditetapkan. Hasil tidak akan dibatasi pada yang berada dalam batas ini; namun, hasil di dalamnya akan berperingkat 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 diikuti dengan nama lokasi ('pizza di New York'), atau nama tempat diikuti disambiguator lokasi ('Starbucks di Sydney'). |
radius optional |
Jenis:
number optional Radius area yang digunakan untuk mencondongkan hasil saat menelusuri Tempat, dalam meter. |
region optional |
Jenis:
string optional Kode wilayah untuk membiaskan hasil. Kode wilayah menerima nilai yang berisi dua karakter ccTLD ("top-level domain"). 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 ini diterjemahkan ke dalam bahasa lokal lokasi target permintaan dan digunakan sebagai string kueri. Jika disediakan, kueri akan disambungkan ke string jenis yang dilokalkan. Hasil dari jenis yang berbeda akan dihapus dari respons. Gunakan kolom ini untuk melakukan penelusuran kategori yang tidak bergantung pada bahasa dan wilayah. Jenis yang valid diberikan di sini. |
Konstanta RankBy
google.maps.places.RankBy
konstanta
Opsi peringkat untuk PlaceSearchRequest.
Akses dengan memanggil const {RankBy} = await google.maps.importLibrary("places")
. Lihat Library di Maps JavaScript API.
Konstanta | |
---|---|
DISTANCE |
Menentukan peringkat hasil tempat menurut jarak dari lokasi. |
PROMINENCE |
Memberi peringkat pada hasil berdasarkan keterlihatannya. |
typedef LocationBias
google.maps.places.LocationBias
typedef
LocationBias mewakili batas lunak atau petunjuk untuk digunakan saat menelusuri 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
Typedef LocationRestriction
google.maps.places.LocationRestriction
typedef
LocationRestriction mewakili batas ketat yang akan digunakan saat menelusuri Tempat.
Konstanta PlacesServiceStatus
google.maps.places.PlacesServiceStatus
konstanta
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
.
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 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 PlaceSearchPagination
Antarmuka
google.maps.places.PlaceSearchPagination
Objek yang digunakan untuk mengambil halaman tambahan hasil Places.
Properti | |
---|---|
hasNextPage |
Jenis:
boolean Menunjukkan apakah tersedia hasil lebih lanjut. 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 ke permintaan penelusuran pertama. |
Antarmuka PlaceResult
Antarmuka
google.maps.places.PlaceResult
Mendefinisikan informasi tentang Tempat.
Properti | |
---|---|
address_components optional |
Jenis:
Array<GeocoderAddressComponent> optional Kumpulan komponen alamat untuk lokasi Place ini. Hanya tersedia dengan PlacesService.getDetails . |
adr_address optional |
Jenis:
string optional Representasi alamat Place dalam format mikro adr. Hanya tersedia dengan PlacesService.getDetails . |
aspects optional |
Jenis:
Array<PlaceAspectRating> optional Aspek yang diberi peringkat dari Tempat ini, berdasarkan ulasan pengguna Google dan Zagat. Ratingnya memiliki 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 untuk sementara atau permanen). Jika tidak ada data yang tersedia, tanda tidak ada di respons penelusuran atau detail. |
formatted_address optional |
Jenis:
string optional Alamat lengkap Tempat tersebut. |
formatted_phone_number optional |
Jenis:
string optional Nomor telepon Place, diformat sesuai dengan konvensi regional nomor tersebut. 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 apa yang telah diminta fields , dan harus ditampilkan. |
icon optional |
Jenis:
string optional URL ke aset 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 mask ikon. Akses berbagai jenis ikon dengan menambahkan ekstensi file ke bagian akhir (misalnya .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. Berhati-hatilah saat menggunakan data ini, karena pengguna yang berbahaya dapat 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 ini tutup, baik secara permanen atau sementara. Jika tempat tersebut beroperasi, atau jika tidak ada data yang tersedia, flag tidak akan 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 "kode plus" untuk Tempat tersebut. |
price_level optional |
Jenis:
number optional Tingkat harga Tempat, dalam 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 untuk Tempat ini. Hanya tersedia dengan PlacesService.getDetails . |
types optional |
Jenis:
Array<string> optional Array dari 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 yang berisi informasi terbaik yang tersedia tentang Tempat ini. 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 di belakang UTC, selisihnya 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 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 di belakang UTC, selisihnya 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 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
Mendefinisikan informasi tentang aspek tempat yang telah diulas oleh pengguna.
Properti | |
---|---|
rating |
Jenis:
number Rating aspek ini. Untuk ulasan individual, ini adalah bilangan bulat dari 0 hingga 3. Untuk peringkat gabungan suatu tempat, ini adalah bilangan bulat dari 0 sampai 30. |
type |
Jenis:
string Jenis aspek. Misalnya, "food" , "decor" , "service" , atau "overall" . |
Konstanta BusinessStatus
google.maps.places.BusinessStatus
konstanta
Status operasional Tempat, jika berupa bisnis, ditampilkan dalam PlaceResult (menunjukkan apakah tempat tersebut beroperasi, atau tutup untuk sementara atau permanen). Tentukan atribut ini berdasarkan nilai, atau nama konstantanya (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 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 disukai saat menampilkan Tempat ini pada 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 ini buka saat ini. |
periods optional |
Jenis:
Array<PlaceOpeningHoursPeriod> optional Periode pembukaan untuk setiap hari dalam sepekan, mulai dari hari Minggu, dalam urutan kronologis. Hari saat Tempat tidak buka tidak termasuk. Hanya tersedia dengan PlacesService.getDetails . |
weekday_text optional |
Jenis:
Array<string> optional Array berisi tujuh string yang mewakili jam buka berformat untuk setiap hari dalam seminggu. Layanan Places akan memformat dan melokalkan jam buka dengan 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 lewat), 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 memerlukan jam khusus, seperti jam di hari libur, sebagai pertimbangan. |
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 periode open
yang berisi day
dengan nilai 0
dan time
dengan nilai "0000"
, dan tanpa close
.
Properti | |
---|---|
open |
Jenis:
PlaceOpeningHoursTime Waktu buka untuk Place. |
close optional |
Jenis:
PlaceOpeningHoursTime optional Waktu tutup untuk Place. |
Antarmuka PlaceOpeningHoursTime
Antarmuka
google.maps.places.PlaceOpeningHoursTime
Menentukan kapan Tempat buka 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 ]. Jam ini akan dilaporkan dalam zona waktu Place. |
minutes |
Jenis:
number Menit PlaceOpeningHoursTime.time sebagai angka, dalam rentang [0 , 59 ]. Menit ini akan dilaporkan dalam zona waktu Place. |
time |
Jenis:
string Waktu dalam format "hhmm" 24 jam. Nilai berada dalam rentang [ "0000" , "2359" ]. Waktu akan dilaporkan dalam zona waktu Place. |
nextDate optional |
Jenis:
number optional Stempel waktu (dalam milidetik sejak epoch, cocok untuk digunakan dengan new Date() ) yang menunjukkan kemunculan PlaceOpeningHoursTime ini berikutnya. Metrik 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 Kode Lokasi Terbuka atau "kode plus" 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 Kode plus dengan 1/8000 derajat dengan 1/8000 luas derajat. Misalnya, "8FVC9G8F+5W" . |
compound_code optional |
Jenis:
string optional Kode plus dengan 1/8000 derajat dengan 1/8000 area 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
Mewakili 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 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 foto profil pengguna yang menerima undangan. |
relative_time_description |
Jenis:
string String waktu terbaru yang diformat, 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 peninjauan, yang 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. Nama ini akan menjadi undefined saat profil pengulas tidak tersedia. |
rating optional |
Jenis:
number optional Rating ulasan ini, angka antara 1,0 dan 5,0 (inklusif). |