Places Service

PlacesService class

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.
PlacesService
PlacesService(attrContainer)
Parameter: 
Membuat instance baru PlacesService yang merender atribusi dalam penampung yang ditentukan.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Mengambil daftar tempat berdasarkan nomor telepon. Biasanya hanya ada satu item dalam daftar hasil, tetapi jika permintaan ambigu, lebih dari satu hasil dapat ditampilkan. PlaceResult yang diteruskan ke callback adalah subkumpulan 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. Biasanya hanya ada satu item dalam daftar hasil, tetapi jika permintaan ambigu, lebih dari satu hasil dapat ditampilkan. PlaceResult yang diteruskan ke callback adalah subkumpulan 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 dicondongkan ke hasil di sekitar, bukan dibatasi ke tempat di dalam area. Gunakan textSearch jika Anda ingin menelusuri tempat menggunakan string arbitrer, dan dalam kasus di mana 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).

PlaceDetailsRequest interface

google.maps.places.PlaceDetailsRequest interface

Kueri detail Tempat yang akan dikirim ke PlacesService.
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 digunakan untuk menampilkan detail. Lihat daftar bahasa yang didukung.
region optional
Jenis:  string optional
Kode wilayah pengguna. Hal ini dapat memengaruhi foto mana 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 menggabungkan permintaan detail dengan sesi pelengkapan otomatis.

Antarmuka FindPlaceFromPhoneNumberRequest

google.maps.places.FindPlaceFromPhoneNumberRequest interface

Permintaan penelusuran tempat dari teks yang akan dikirim ke PlacesService.findPlaceFromPhoneNumber.
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 dicondongkan ke, tetapi tidak terbatas pada, LocationBias yang diberikan.

Antarmuka FindPlaceFromQueryRequest

google.maps.places.FindPlaceFromQueryRequest interface

Permintaan penelusuran tempat dari teks yang akan dikirim ke PlacesService.findPlaceFromQuery.
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 dicondongkan ke, tetapi tidak terbatas pada, LocationBias yang diberikan.

PlaceSearchRequest interface

google.maps.places.PlaceSearchRequest interface

Kueri penelusuran Tempat yang akan dikirim ke PlacesService.
bounds optional
Batas untuk menelusuri Tempat. location dan radius akan diabaikan jika bounds disetel.
keyword optional
Jenis:  string optional
Istilah yang akan dicocokkan dengan semua kolom yang tersedia, termasuk, tetapi tidak terbatas pada nama, jenis, dan alamat, serta ulasan pelanggan dan konten pihak ketiga lainnya.
language optional
Jenis:  string optional
ID bahasa untuk bahasa yang digunakan untuk menampilkan nama dan alamat, jika memungkinkan. Lihat daftar bahasa yang didukung.
location optional
Jenis:  LatLng|LatLngLiteral optional
Lokasi sekitar untuk menelusuri Tempat.
maxPriceLevel optional
Jenis:  number optional
Membatasi hasil hanya ke tempat yang berada 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 kurang dari atau sama dengan maxPrice, jika ditentukan.
name optional
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 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 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 yang diberikan. 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

google.maps.places.TextSearchRequest interface

Permintaan penelusuran teks yang akan dikirim ke PlacesService.
bounds optional
Batas yang digunakan untuk memengaruhi hasil saat menelusuri Tempat (opsional). location dan radius akan diabaikan jika bounds disetel. 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 memengaruhi hasil saat menelusuri Tempat.
query optional
Jenis:  string optional
Istilah kueri permintaan. Misalnya, nama tempat ('Menara Eiffel'), kategori yang diikuti dengan nama lokasi ('pizza di New York'), atau nama tempat yang diikuti dengan penentu lokasi ('Starbucks di Sydney').
radius optional
Jenis:  number optional
Radius area yang digunakan untuk membiaskan hasil saat menelusuri Tempat, dalam meter.
region optional
Jenis:  string optional
Kode wilayah untuk membiaskan hasil. Kode wilayah menerima nilai dua karakter ccTLD ("domain level teratas"). Umumnya kode ccTLD identik dengan kode ISO 3166-1, dengan beberapa pengecualian. Misalnya, ccTLD Inggris Raya adalah "uk" (.co.uk), sedangkan kode ISO 3166-1-nya adalah "gb" (secara teknis untuk entitas "The United Kingdom of Great Britain and Northern Ireland").
type optional
Jenis:  string optional
Menelusuri tempat dengan jenis yang diberikan. 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 konstanta

Opsi peringkat untuk PlaceSearchRequest.

Akses dengan memanggil const {RankBy} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.
DISTANCE Memeringkat hasil tempat berdasarkan jarak dari lokasi.
PROMINENCE Memberi peringkat hasil tempat berdasarkan keterlihatannya.

LocationBias typedef

google.maps.places.LocationBias typedef

LocationBias merepresentasikan batas atau petunjuk tidak ketat 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

LocationRestriction typedef

google.maps.places.LocationRestriction typedef

LocationRestriction merepresentasikan batas ketat yang akan digunakan saat menelusuri Tempat.

LatLngBounds|LatLngBoundsLiteral

Konstanta PlacesServiceStatus

google.maps.places.PlacesServiceStatus konstanta

Status yang ditampilkan oleh PlacesService setelah penelusurannya selesai. Tentukan ini berdasarkan nilai, atau 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.
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.