Indeks
Places
(antarmuka)AddressDescriptor
(pesan)AddressDescriptor.Area
(pesan)AddressDescriptor.Area.Containment
(enum)AddressDescriptor.Landmark
(pesan)AddressDescriptor.Landmark.SpatialRelationship
(enum)AuthorAttribution
(pesan)AutocompletePlacesRequest
(pesan)AutocompletePlacesRequest.LocationBias
(pesan)AutocompletePlacesRequest.LocationRestriction
(pesan)AutocompletePlacesResponse
(pesan)AutocompletePlacesResponse.Suggestion
(pesan)AutocompletePlacesResponse.Suggestion.FormattableText
(pesan)AutocompletePlacesResponse.Suggestion.PlacePrediction
(pesan)AutocompletePlacesResponse.Suggestion.QueryPrediction
(pesan)AutocompletePlacesResponse.Suggestion.StringRange
(pesan)AutocompletePlacesResponse.Suggestion.StructuredFormat
(pesan)Circle
(pesan)ContentBlock
(pesan)ContextualContent
(pesan)ContextualContent.Justification
(pesan)ContextualContent.Justification.BusinessAvailabilityAttributesJustification
(pesan)ContextualContent.Justification.ReviewJustification
(pesan)ContextualContent.Justification.ReviewJustification.HighlightedText
(pesan)ContextualContent.Justification.ReviewJustification.HighlightedText.HighlightedTextRange
(pesan)EVChargeOptions
(pesan)EVChargeOptions.ConnectorAggregation
(pesan)EVConnectorType
(enum)FuelOptions
(pesan)FuelOptions.FuelPrice
(pesan)FuelOptions.FuelPrice.FuelType
(enum)GetPhotoMediaRequest
(pesan)GetPlaceRequest
(pesan)Photo
(pesan)PhotoMedia
(pesan)Place
(pesan)Place.AccessibilityOptions
(pesan)Place.AddressComponent
(pesan)Place.AreaSummary
(pesan)Place.Attribution
(pesan)Place.BusinessStatus
(enum)Place.ContainingPlace
(pesan)Place.GenerativeSummary
(pesan)Place.GoogleMapsLinks
(pesan)Place.OpeningHours
(pesan)Place.OpeningHours.Period
(pesan)Place.OpeningHours.Period.Point
(pesan)Place.OpeningHours.SecondaryHoursType
(enum)Place.OpeningHours.SpecialDay
(pesan)Place.ParkingOptions
(pesan)Place.PaymentOptions
(pesan)Place.PlusCode
(pesan)Place.SubDestination
(pesan)Polyline
(pesan)PriceLevel
(enum)PriceRange
(pesan)References
(pesan)Review
(pesan)RouteModifiers
(pesan)RoutingParameters
(pesan)RoutingPreference
(enum)RoutingSummary
(pesan)RoutingSummary.Leg
(pesan)SearchNearbyRequest
(pesan)SearchNearbyRequest.LocationRestriction
(pesan)SearchNearbyRequest.RankPreference
(enum)SearchNearbyResponse
(pesan)SearchTextRequest
(pesan)SearchTextRequest.EVOptions
(pesan)SearchTextRequest.LocationBias
(pesan)SearchTextRequest.LocationRestriction
(pesan)SearchTextRequest.RankPreference
(enum)SearchTextRequest.SearchAlongRouteParameters
(pesan)SearchTextResponse
(pesan)TravelMode
(enum)
Tempat
Definisi layanan untuk Places API. Catatan: setiap permintaan (kecuali untuk permintaan Autocomplete) memerlukan mask kolom yang ditetapkan di luar proto permintaan (all/*
, tidak diasumsikan). Mask kolom dapat ditetapkan melalui header HTTP X-Goog-FieldMask
. Lihat: https://developers.google.com/maps/documentation/places/web-service/choose-fields
AutocompletePlaces |
---|
Menampilkan prediksi untuk input yang diberikan.
|
GetPhotoMedia |
---|
Mendapatkan media foto dengan string referensi foto.
|
GetPlace |
---|
Mendapatkan detail tempat berdasarkan nama resource-nya, yang merupakan string dalam format
|
SearchNearby |
---|
Menelusuri tempat di dekat lokasi.
|
SearchText |
---|
Penelusuran tempat berbasis kueri teks.
|
AddressDescriptor
Deskripsi relasional lokasi. Mencakup kumpulan penanda terdekat yang diberi peringkat dan area penampung yang akurat serta hubungannya dengan lokasi target.
Kolom | |
---|---|
landmarks[] |
Daftar tempat terkenal di sekitar yang diberi peringkat. Penanda terdekat dan yang paling mudah dikenali akan diberi peringkat pertama. |
areas[] |
Daftar yang diurutkan berdasarkan area yang berisi atau berdekatan. Area yang paling mudah dikenali dan akurat akan diberi peringkat pertama. |
Area
Informasi area dan hubungan area dengan lokasi target.
Area mencakup sublokalitas, lingkungan, dan kompleks besar yang akurat yang berguna untuk mendeskripsikan lokasi.
Kolom | |
---|---|
name |
Nama resource area. |
place_id |
ID tempat area. |
display_name |
Nama tampilan area. |
containment |
Menentukan hubungan spasial antara lokasi target dan area. |
Pembatasan
Menentukan hubungan spasial antara lokasi target dan area.
Enum | |
---|---|
CONTAINMENT_UNSPECIFIED |
Pembatasan tidak ditentukan. |
WITHIN |
Lokasi target berada dalam wilayah area, dekat dengan pusat. |
OUTSKIRTS |
Lokasi target berada dalam wilayah area, dekat dengan tepi. |
NEAR |
Lokasi target berada di luar wilayah area, tetapi berdekatan. |
Tempat terkenal
Informasi penanda dasar dan hubungan penanda dengan lokasi target.
Penanda adalah tempat yang mudah dikenali dan dapat digunakan untuk mendeskripsikan lokasi.
Kolom | |
---|---|
name |
Nama resource penanda. |
place_id |
ID tempat penanda. |
display_name |
Nama tampilan penanda. |
types[] |
Kumpulan tag jenis untuk penanda ini. Untuk mengetahui daftar lengkap nilai yang mungkin, lihat https://developers.google.com/maps/documentation/places/web-service/place-types. |
spatial_relationship |
Menentukan hubungan spasial antara lokasi target dan penanda. |
straight_line_distance_meters |
Jarak garis lurus, dalam meter, antara titik tengah target dan titik tengah penanda. Dalam beberapa situasi, nilai ini dapat lebih panjang dari |
travel_distance_meters |
Jarak perjalanan, dalam meter, di sepanjang jaringan jalan dari target ke penanda, jika diketahui. Nilai ini tidak memperhitungkan moda transportasi, seperti berjalan kaki, mengemudi, atau bersepeda. |
SpatialRelationship
Menentukan hubungan spasial antara lokasi target dan penanda.
Enum | |
---|---|
NEAR |
Ini adalah hubungan default jika tidak ada yang lebih spesifik di bawah ini yang berlaku. |
WITHIN |
Penanda memiliki geometri spasial dan target berada dalam batasnya. |
BESIDE |
Target berada tepat di samping penanda. |
ACROSS_THE_ROAD |
Target berada tepat di seberang penanda di sisi lain jalan. |
DOWN_THE_ROAD |
Di rute yang sama dengan penanda, tetapi tidak di samping atau di seberang. |
AROUND_THE_CORNER |
Tidak berada di rute yang sama dengan penanda, tetapi hanya satu belokan. |
BEHIND |
Dekat dengan struktur penanda tetapi lebih jauh dari pintu masuk jalannya. |
AuthorAttribution
Informasi tentang penulis data UGC. Digunakan di Photo
, dan Review
.
AutocompletePlacesRequest
Meminta proto untuk AutocompletePlaces.
Kolom | |
---|---|
input |
Wajib. String teks yang akan ditelusuri. |
location_bias |
Opsional. Membiaskan hasil ke lokasi yang ditentukan. Maksimal satu dari |
location_restriction |
Opsional. Membatasi hasil ke lokasi yang ditentukan. Maksimal satu dari |
included_primary_types[] |
Opsional. Menyertakan jenis Tempat utama (misalnya, "restaurant" atau "gas_station") di Jenis Tempat (https://developers.google.com/maps/documentation/places/web-service/place-types), atau hanya |
included_region_codes[] |
Opsional. Hanya sertakan hasil di wilayah yang ditentukan, yang ditentukan sebagai maksimal 15 kode wilayah dua karakter CLDR. Set kosong tidak akan membatasi hasil. Jika |
language_code |
Opsional. Bahasa yang digunakan untuk menampilkan hasil. Setelan defaultnya adalah en-US. Hasilnya mungkin dalam bahasa campuran jika bahasa yang digunakan di |
region_code |
Opsional. Kode wilayah, yang ditentukan sebagai kode wilayah dua karakter CLDR. Hal ini memengaruhi format alamat, peringkat hasil, dan dapat memengaruhi hasil yang ditampilkan. Hal ini tidak membatasi hasil ke wilayah yang ditentukan. Untuk membatasi hasil ke region, gunakan |
origin |
Opsional. Titik asal tempat jarak geodesik dihitung ke tujuan (ditampilkan sebagai |
input_offset |
Opsional. Offset karakter Unicode berbasis nol dari Jika kosong, setelan defaultnya adalah panjang |
include_query_predictions |
Opsional. Jika benar, respons akan menyertakan prediksi Place dan kueri. Jika tidak, respons hanya akan menampilkan prediksi Tempat. |
session_token |
Opsional. String yang mengidentifikasi sesi Autocomplete untuk tujuan penagihan. Harus berupa string base64 yang aman untuk URL dan nama file dengan panjang maksimum 36 karakter ASCII. Jika tidak, error INVALID_ARGUMENT akan ditampilkan. Sesi dimulai saat pengguna mulai mengetik kueri, dan berakhir saat mereka memilih tempat dan panggilan ke Place Details atau Address Validation dilakukan. Setiap sesi dapat memiliki beberapa kueri, yang diikuti dengan satu permintaan Place Details atau Address Validation. Kredensial yang digunakan untuk setiap permintaan dalam sesi harus berasal dari project Konsol Google Cloud yang sama. Setelah sesi selesai, token tidak lagi valid; aplikasi Anda harus membuat token baru untuk setiap sesi. Jika parameter Sebaiknya ikuti panduan berikut:
|
include_pure_service_area_businesses |
Opsional. Sertakan bisnis jasa sistem panggilan murni jika kolom ditetapkan ke benar. Bisnis jasa sistem panggilan murni adalah bisnis yang melakukan kunjungan atau pengiriman ke pelanggan secara langsung, tetapi tidak melayani pelanggan di alamat bisnisnya. Misalnya, bisnis seperti layanan kebersihan atau tukang leding. Bisnis tersebut tidak memiliki alamat atau lokasi fisik di Google Maps. Places tidak akan menampilkan kolom termasuk |
LocationBias
Wilayah yang akan ditelusuri. Hasilnya mungkin bias di sekitar wilayah yang ditentukan.
LocationRestriction
Wilayah yang akan ditelusuri. Hasil akan dibatasi pada wilayah yang ditentukan.
AutocompletePlacesResponse
Proto respons untuk AutocompletePlaces.
Kolom | |
---|---|
suggestions[] |
Berisi daftar saran, yang diurutkan dalam urutan relevansi menurun. |
Saran
Hasil saran Autocomplete.
Kolom | |
---|---|
Kolom union
|
|
place_prediction |
Prediksi untuk Tempat. |
query_prediction |
Prediksi untuk kueri. |
FormattableText
Teks yang mewakili Tempat atau prediksi kueri. Teks dapat digunakan apa adanya atau diformat.
Kolom | |
---|---|
text |
Teks yang dapat digunakan apa adanya atau diformat dengan |
matches[] |
Daftar rentang string yang mengidentifikasi tempat permintaan input dicocokkan di Nilai ini adalah offset karakter Unicode dari |
PlacePrediction
Hasil prediksi untuk prediksi Place Autocomplete.
Kolom | |
---|---|
place |
Nama resource Tempat yang disarankan. Nama ini dapat digunakan di API lain yang menerima nama Tempat. |
place_id |
ID unik Tempat yang disarankan. ID ini dapat digunakan di API lain yang menerima ID Tempat. |
text |
Berisi nama yang dapat dibaca manusia untuk hasil yang ditampilkan. Untuk hasil tempat, ini biasanya adalah nama dan alamat bisnis.
Teks ini mungkin berbeda dengan Mungkin dalam bahasa campuran jika permintaan |
structured_format |
Perincian prediksi Tempat menjadi teks utama yang berisi nama Tempat dan teks sekunder yang berisi fitur disambiguasi tambahan (seperti kota atau wilayah).
|
types[] |
Daftar jenis yang berlaku untuk Tempat ini dari Tabel A atau Tabel B di https://developers.google.com/maps/documentation/places/web-service/place-types. Jenis adalah kategorisasi Tempat. Tempat dengan jenis yang sama akan memiliki karakteristik yang serupa. |
distance_meters |
Panjang geodesi dalam meter dari |
QueryPrediction
Hasil prediksi untuk prediksi Autocomplete Kueri.
Kolom | |
---|---|
text |
Teks yang diprediksi. Teks ini tidak mewakili Tempat, tetapi merupakan kueri teks yang dapat digunakan di endpoint penelusuran (misalnya, Text Search).
Mungkin dalam bahasa campuran jika permintaan |
structured_format |
Perincian prediksi kueri menjadi teks utama yang berisi kueri dan teks sekunder yang berisi fitur disambiguasi tambahan (seperti kota atau wilayah).
|
StringRange
Mengidentifikasi substring dalam teks tertentu.
Kolom | |
---|---|
start_offset |
Offset berbasis nol dari karakter Unicode pertama string (inklusif). |
end_offset |
Offset berbasis nol dari karakter Unicode terakhir (eksklusif). |
StructuredFormat
Berisi pengelompokan prediksi Tempat atau kueri menjadi teks utama dan teks sekunder.
Untuk prediksi Tempat, teks utama berisi nama spesifik Tempat. Untuk prediksi kueri, teks utama berisi kueri.
Teks sekunder berisi fitur pemisahan tambahan (seperti kota atau wilayah) untuk mengidentifikasi Tempat lebih lanjut atau menyaring kueri.
Kolom | |
---|---|
main_text |
Mewakili nama Tempat atau kueri. |
secondary_text |
Merepresentasikan fitur disambiguasi tambahan (seperti kota atau wilayah) untuk mengidentifikasi Tempat lebih lanjut atau menyaring kueri. |
Lingkaran
Lingkaran dengan LatLng sebagai pusat dan radius.
Kolom | |
---|---|
center |
Wajib. Lintang dan bujur tengah. Rentang lintang harus berada dalam [-90.0, 90.0]. Rentang bujur harus berada dalam [-180.0, 180.0]. |
radius |
Wajib. Radius diukur dalam meter. Radius harus berada dalam [0.0, 50000.0]. |
ContentBlock
Blok konten yang dapat ditayangkan satu per satu.
Kolom | |
---|---|
topic |
Topik konten, misalnya "ringkasan" atau "restoran". |
content |
Konten yang terkait dengan topik. |
references |
Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya. Referensi yang terkait dengan blok konten ini. |
ContextualContent
Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya.
Konten yang kontekstual dengan kueri tempat.
Kolom | |
---|---|
reviews[] |
Daftar ulasan tentang tempat ini, yang kontekstual dengan kueri tempat. |
photos[] |
Informasi (termasuk referensi) tentang foto tempat ini, yang kontekstual dengan kueri tempat. |
justifications[] |
Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya. Justifikasi untuk tempat. |
Pembenaran
Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya.
Justifikasi untuk tempat. Justifikasi menjawab pertanyaan mengapa suatu tempat dapat menarik minat pengguna akhir.
Kolom | |
---|---|
Kolom union
|
|
review_justification |
Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya. |
business_availability_attributes_justification |
Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya. |
BusinessAvailabilityAttributesJustification
Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya. Justifikasi BusinessAvailabilityAttributes. Ini menunjukkan beberapa atribut yang dimiliki bisnis yang dapat menarik minat pengguna akhir.
Kolom | |
---|---|
takeout |
Apakah tempat menyediakan opsi bawa pulang. |
delivery |
Apakah tempat ini menyediakan layanan pesan antar. |
dine_in |
Apakah tempat tersebut menyediakan layanan makan di tempat. |
ReviewJustification
Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya.
Justifikasi ulasan pengguna. Hal ini menyoroti bagian ulasan pengguna yang akan menarik bagi pengguna akhir. Misalnya, jika kueri penelusurannya adalah "firewood pizza", justifikasi ulasan akan menandai teks yang relevan dengan kueri penelusuran.
Kolom | |
---|---|
highlighted_text |
|
review |
Ulasan yang menjadi sumber teks yang ditandai. |
HighlightedText
Teks yang ditandai oleh justifikasi. Ini adalah subkumpulan dari ulasan itu sendiri. Kata persis yang akan ditandai ditandai oleh HighlightedTextRange. Mungkin ada beberapa kata dalam teks yang ditandai.
Kolom | |
---|---|
text |
|
highlighted_text_ranges[] |
Daftar rentang teks yang ditandai. |
HighlightedTextRange
Rentang teks yang ditandai.
Kolom | |
---|---|
start_index |
|
end_index |
|
EVChargeOptions
Informasi tentang Stasiun Pengisian Kendaraan Listrik Umum yang dihosting di Tempat. Terminologi mengikuti https://afdc.energy.gov/fuels/electricity_infrastructure.html Satu port dapat mengisi daya satu mobil dalam satu waktu. Satu port memiliki satu atau beberapa konektor. Satu stasiun memiliki satu atau beberapa port.
Kolom | |
---|---|
connector_count |
Jumlah konektor di stasiun ini. Namun, karena beberapa port dapat memiliki beberapa konektor, tetapi hanya dapat mengisi daya satu mobil dalam satu waktu (misalnya), jumlah konektor mungkin lebih besar dari jumlah total mobil yang dapat mengisi daya secara bersamaan. |
connector_aggregation[] |
Daftar agregasi konektor pengisian daya kendaraan listrik yang berisi konektor dengan jenis dan tarif pengisian daya yang sama. |
ConnectorAggregation
Informasi pengisian daya kendaraan listrik yang dikelompokkan menurut [type, max_charge_rate_kw]. Menampilkan agregasi pengisian daya Kendaraan Listrik dari konektor yang memiliki jenis dan tarif pengisian daya maksimum yang sama dalam kw.
Kolom | |
---|---|
type |
Jenis konektor agregasi ini. |
max_charge_rate_kw |
Kecepatan pengisian daya maksimum statis dalam kw dari setiap konektor dalam agregasi. |
count |
Jumlah konektor dalam agregasi ini. |
availability_last_update_time |
Stempel waktu saat informasi ketersediaan konektor dalam agregasi ini terakhir diperbarui. |
available_count |
Jumlah konektor dalam agregasi ini yang saat ini tersedia. |
out_of_service_count |
Jumlah konektor dalam agregasi ini yang saat ini tidak dapat digunakan. |
EVConnectorType
Lihat http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 untuk informasi/konteks tambahan tentang jenis konektor pengisian daya kendaraan listrik.
Enum | |
---|---|
EV_CONNECTOR_TYPE_UNSPECIFIED |
Konektor tidak ditentukan. |
EV_CONNECTOR_TYPE_OTHER |
Jenis konektor lainnya. |
EV_CONNECTOR_TYPE_J1772 |
Konektor J1772 jenis 1. |
EV_CONNECTOR_TYPE_TYPE_2 |
Konektor IEC 62196 tipe 2. Sering disebut sebagai MENNEKES. |
EV_CONNECTOR_TYPE_CHADEMO |
Konektor jenis CHAdeMO. |
EV_CONNECTOR_TYPE_CCS_COMBO_1 |
Combined Charging System (AC dan DC). Berdasarkan SAE. Konektor J-1772 Type-1 |
EV_CONNECTOR_TYPE_CCS_COMBO_2 |
Combined Charging System (AC dan DC). Berdasarkan konektor Mennekes Tipe-2 |
EV_CONNECTOR_TYPE_TESLA |
Konektor TESLA generik. Ini adalah NACS di Amerika Utara, tetapi dapat berupa non-NACS di bagian lain dunia (misalnya, CCS Combo 2 (CCS2) atau GB/T). Nilai ini kurang mewakili jenis konektor sebenarnya, dan lebih mewakili kemampuan untuk mengisi daya kendaraan merek Tesla di stasiun pengisian daya milik Tesla. |
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T |
Jenis GB/T sesuai dengan standar GB/T di China. Jenis ini mencakup semua jenis GB_T. |
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET |
Stopkontak tidak ditentukan. |
EV_CONNECTOR_TYPE_NACS |
North American Charging System (NACS), yang distandarisasi sebagai SAE J3400. |
FuelOptions
Informasi terbaru tentang opsi bahan bakar di SPBU. Informasi ini diperbarui secara berkala.
Kolom | |
---|---|
fuel_prices[] |
Harga bahan bakar terakhir yang diketahui untuk setiap jenis bahan bakar yang tersedia di SPBU ini. Ada satu entri per jenis bahan bakar yang dimiliki stasiun ini. Urutan tidak penting. |
FuelPrice
Informasi harga bahan bakar untuk jenis tertentu.
FuelType
Jenis bahan bakar.
Enum | |
---|---|
FUEL_TYPE_UNSPECIFIED |
Jenis bahan bakar tidak ditentukan. |
DIESEL |
Bahan bakar diesel. |
DIESEL_PLUS |
Solar plus bahan bakar. |
REGULAR_UNLEADED |
Bensin tanpa timbal biasa. |
MIDGRADE |
Menengah. |
PREMIUM |
Premium. |
SP91 |
SP 91. |
SP91_E10 |
SP 91 E10. |
SP92 |
SP 92. |
SP95 |
SP 95. |
SP95_E10 |
SP95 E10. |
SP98 |
SP 98. |
SP99 |
SP 99. |
SP100 |
SP 100. |
LPG |
Gas Minyak Cair. |
E80 |
E 80. |
E85 |
E 85. |
E100 |
E 100. |
METHANE |
Metana. |
BIO_DIESEL |
Biodiesel. |
TRUCK_DIESEL |
Diesel truk. |
GetPhotoMediaRequest
Permintaan untuk mengambil foto tempat menggunakan nama resource foto.
Kolom | |
---|---|
name |
Wajib. Nama resource media foto dalam format: Nama resource foto seperti yang ditampilkan di kolom |
max_width_px |
Opsional. Menentukan lebar maksimum yang diinginkan, dalam piksel, dari gambar. Jika gambar lebih kecil dari nilai yang ditentukan, gambar asli akan ditampilkan. Jika gambar lebih besar di salah satu dimensi, gambar akan diskalakan agar sesuai dengan dimensi yang lebih kecil, yang dibatasi pada rasio aspek aslinya. Properti max_height_px dan max_width_px menerima bilangan bulat antara 1 dan 4800, inklusif. Jika nilai tidak berada dalam rentang yang diizinkan, error INVALID_ARGUMENT akan ditampilkan. Setidaknya salah satu dari max_height_px atau max_width_px harus ditentukan. Jika max_height_px atau max_width_px tidak ditentukan, error INVALID_ARGUMENT akan ditampilkan. |
max_height_px |
Opsional. Menentukan tinggi maksimum yang diinginkan, dalam piksel, dari gambar. Jika gambar lebih kecil dari nilai yang ditentukan, gambar asli akan ditampilkan. Jika gambar lebih besar di salah satu dimensi, gambar akan diskalakan agar sesuai dengan dimensi yang lebih kecil, yang dibatasi pada rasio aspek aslinya. Properti max_height_px dan max_width_px menerima bilangan bulat antara 1 dan 4800, inklusif. Jika nilai tidak berada dalam rentang yang diizinkan, error INVALID_ARGUMENT akan ditampilkan. Setidaknya salah satu dari max_height_px atau max_width_px harus ditentukan. Jika max_height_px atau max_width_px tidak ditentukan, error INVALID_ARGUMENT akan ditampilkan. |
skip_http_redirect |
Opsional. Jika ditetapkan, lewati perilaku pengalihan HTTP default dan render respons format teks (misalnya, dalam format JSON untuk kasus penggunaan HTTP). Jika tidak ditetapkan, pengalihan HTTP akan dikeluarkan untuk mengalihkan panggilan ke media gambar. Opsi ini diabaikan untuk permintaan non-HTTP. |
GetPlaceRequest
Permintaan untuk mengambil Tempat berdasarkan nama resource-nya, yang merupakan string dalam format places/{place_id}
.
Kolom | |
---|---|
name |
Wajib. Nama resource tempat, dalam format |
language_code |
Opsional. Detail tempat akan ditampilkan dengan bahasa pilihan jika tersedia. Daftar bahasa yang didukung saat ini: https://developers.google.com/maps/faq#languagesupport. |
region_code |
Opsional. Kode negara/wilayah Unicode (CLDR) lokasi asal permintaan. Parameter ini digunakan untuk menampilkan detail tempat, seperti nama tempat khusus wilayah, jika tersedia. Parameter ini dapat memengaruhi hasil berdasarkan hukum yang berlaku. Untuk informasi selengkapnya, lihat https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. Perhatikan bahwa kode wilayah 3 digit saat ini tidak didukung. |
session_token |
Opsional. String yang mengidentifikasi sesi Autocomplete untuk tujuan penagihan. Harus berupa string base64 yang aman untuk URL dan nama file dengan panjang maksimum 36 karakter ASCII. Jika tidak, error INVALID_ARGUMENT akan ditampilkan. Sesi dimulai saat pengguna mulai mengetik kueri, dan berakhir saat mereka memilih tempat dan panggilan ke Place Details atau Address Validation dilakukan. Setiap sesi dapat memiliki beberapa kueri, yang diikuti dengan satu permintaan Place Details atau Address Validation. Kredensial yang digunakan untuk setiap permintaan dalam sesi harus berasal dari project Konsol Google Cloud yang sama. Setelah sesi selesai, token tidak lagi valid; aplikasi Anda harus membuat token baru untuk setiap sesi. Jika parameter Sebaiknya ikuti panduan berikut:
|
Foto
Informasi tentang foto suatu tempat.
Kolom | |
---|---|
name |
ID. Referensi yang mewakili foto tempat ini yang dapat digunakan untuk mencari foto tempat ini lagi (juga disebut nama "resource" API: |
width_px |
Lebar maksimum yang tersedia, dalam piksel. |
height_px |
Tinggi maksimum yang tersedia, dalam piksel. |
author_attributions[] |
Penulis foto ini. |
flag_content_uri |
Link tempat pengguna dapat melaporkan masalah pada foto. |
google_maps_uri |
Link untuk menampilkan foto di Google Maps. |
PhotoMedia
Media foto dari Places API.
Kolom | |
---|---|
name |
Nama resource media foto dalam format: |
photo_uri |
URI berumur pendek yang dapat digunakan untuk merender foto. |
Tempat
Semua informasi yang mewakili Tempat.
Kolom | |
---|---|
name |
Nama resource Tempat ini, dalam format |
id |
ID unik tempat. |
display_name |
Nama tempat yang dilokalkan, cocok sebagai deskripsi singkat yang dapat dibaca manusia. Misalnya, "Google Sydney", "Starbucks", "Pyrmont", dll. |
types[] |
Kumpulan tag jenis untuk hasil ini. Misalnya, "politik" dan "lokalitas". Untuk mengetahui daftar lengkap nilai yang mungkin, lihat Tabel A dan Tabel B di https://developers.google.com/maps/documentation/places/web-service/place-types |
primary_type |
Jenis utama hasil yang diberikan. Jenis ini harus berupa salah satu jenis yang didukung Places API. Misalnya, "restoran", "kafe", "bandara", dll. Suatu tempat hanya dapat memiliki satu jenis utama. Untuk mengetahui daftar lengkap nilai yang mungkin, lihat Tabel A dan Tabel B di https://developers.google.com/maps/documentation/places/web-service/place-types |
primary_type_display_name |
Nama tampilan jenis utama, yang dilokalkan ke bahasa permintaan jika berlaku. Untuk mengetahui daftar lengkap nilai yang mungkin, lihat Tabel A dan Tabel B di https://developers.google.com/maps/documentation/places/web-service/place-types |
national_phone_number |
Nomor telepon yang dapat dibaca manusia untuk tempat tersebut, dalam format nasional. |
international_phone_number |
Nomor telepon yang dapat dibaca manusia untuk tempat tersebut, dalam format internasional. |
formatted_address |
Alamat lengkap yang dapat dibaca manusia untuk tempat ini. |
short_formatted_address |
Alamat singkat yang dapat dibaca manusia untuk tempat ini. |
address_components[] |
Komponen berulang untuk setiap tingkat lokalitas. Perhatikan fakta berikut tentang array address_components[]: - Array komponen alamat dapat berisi lebih banyak komponen daripada formatted_address. - Array tidak harus selalu menyertakan semua entitas politik yang berisi alamat, selain dari yang disertakan dalam formatted_address. Untuk mengambil semua entitas politik yang berisi alamat tertentu, Anda harus menggunakan geocoding terbalik, yang meneruskan lintang/bujur alamat sebagai parameter ke permintaan tersebut. - Format respons tidak dijamin tetap sama di antara permintaan. Secara khusus, jumlah address_components bervariasi berdasarkan alamat yang diminta dan dapat berubah dari waktu ke waktu untuk alamat yang sama. Komponen dapat mengubah posisi dalam array. Jenis komponen dapat berubah. Komponen tertentu mungkin tidak ada dalam respons berikutnya. |
plus_code |
Plus Codes lintang/bujur lokasi tempat. |
location |
Posisi tempat ini. |
viewport |
Area tampilan yang sesuai untuk menampilkan tempat pada peta berukuran rata-rata. Area pandang ini tidak boleh digunakan sebagai batas fisik atau area layanan bisnis. |
rating |
Rating antara 1,0 dan 5,0, berdasarkan ulasan pengguna tentang tempat ini. |
google_maps_uri |
URL yang memberikan informasi selengkapnya tentang tempat ini. |
website_uri |
Situs resmi untuk tempat ini, misalnya halaman beranda bisnis. Perhatikan bahwa untuk tempat yang merupakan bagian dari jaringan (misalnya, toko IKEA), situs ini biasanya adalah situs untuk setiap toko, bukan keseluruhan jaringan. |
reviews[] |
Daftar ulasan tentang tempat ini, diurutkan menurut relevansi. Maksimum 5 ulasan dapat ditampilkan. |
regular_opening_hours |
Jam operasional reguler. Perhatikan bahwa jika tempat selalu buka (24 jam), kolom |
time_zone |
Zona waktu Database Zona Waktu IANA. Misalnya "America/New_York". |
photos[] |
Informasi (termasuk referensi) tentang foto tempat ini. Maksimum 10 foto dapat ditampilkan. |
adr_format_address |
Alamat tempat dalam microformat adr: http://microformats.org/wiki/adr. |
business_status |
Status bisnis untuk tempat. |
price_level |
Tingkat harga tempat. |
attributions[] |
Kumpulan penyedia data yang harus ditampilkan dengan hasil ini. |
icon_mask_base_uri |
URL yang terpotong ke masker ikon. Pengguna dapat mengakses berbagai jenis ikon dengan menambahkan akhiran jenis di bagian akhir (misalnya, ".svg" atau ".png"). |
icon_background_color |
Warna latar belakang untuk icon_mask dalam format heksadesimal, misalnya #909CE1. |
current_opening_hours |
Jam buka selama tujuh hari ke depan (termasuk hari ini). Periode waktu dimulai pada tengah malam pada tanggal permintaan dan berakhir pada pukul 23.59 enam hari kemudian. Kolom ini mencakup subkolom special_days dari semua jam, yang ditetapkan untuk tanggal yang memiliki jam khusus. |
current_secondary_opening_hours[] |
Berisi array entri untuk tujuh hari ke depan, termasuk informasi tentang jam buka sekunder bisnis. Jam buka sekunder berbeda dengan jam buka utama bisnis. Misalnya, restoran dapat menentukan jam layanan drive-thru atau jam layanan pesan antar sebagai jam buka sekundernya. Kolom ini mengisi subkolom jenis, yang diambil dari daftar jenis jam buka yang telah ditentukan sebelumnya (seperti DRIVE_THROUGH, PICKUP, atau TAKEOUT) berdasarkan jenis tempat. Kolom ini mencakup subkolom special_days dari semua jam, yang ditetapkan untuk tanggal yang memiliki jam khusus. |
regular_secondary_opening_hours[] |
Berisi array entri untuk informasi tentang jam sekunder reguler bisnis. Jam buka sekunder berbeda dengan jam buka utama bisnis. Misalnya, restoran dapat menentukan jam layanan drive-thru atau jam layanan pesan antar sebagai jam buka sekundernya. Kolom ini mengisi subkolom jenis, yang diambil dari daftar jenis jam buka yang telah ditentukan sebelumnya (seperti DRIVE_THROUGH, PICKUP, atau TAKEOUT) berdasarkan jenis tempat. |
editorial_summary |
Berisi ringkasan tempat. Ringkasan terdiri dari ringkasan teks, dan juga menyertakan kode bahasa untuk ringkasan tersebut jika berlaku. Teks ringkasan harus ditampilkan apa adanya dan tidak dapat diubah atau dimodifikasi. |
payment_options |
Opsi pembayaran yang diterima tempat tersebut. Jika data opsi pembayaran tidak tersedia, kolom opsi pembayaran tidak akan ditetapkan. |
parking_options |
Opsi parkir yang disediakan oleh tempat. |
sub_destinations[] |
Daftar sub-tujuan yang terkait dengan tempat. |
fuel_options |
Informasi terbaru tentang opsi bahan bakar di SPBU. Informasi ini diperbarui secara berkala. |
ev_charge_options |
Informasi tentang opsi pengisian daya kendaraan listrik. |
generative_summary |
Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya. Ringkasan tempat yang dibuat AI. |
area_summary |
Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya. Ringkasan area tempat bisnis berada yang dibuat AI. |
containing_places[] |
Daftar tempat tempat lokasi saat ini berada. |
address_descriptor |
Deskripsi alamat tempat. Deskripsi alamat menyertakan informasi tambahan yang membantu mendeskripsikan lokasi menggunakan penanda dan area. Lihat cakupan regional deskripsi alamat di https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage. |
google_maps_links |
Link untuk memicu berbagai tindakan Google Maps. |
price_range |
Rentang harga yang terkait dengan Tempat. |
utc_offset_minutes |
Jumlah menit zona waktu tempat ini saat ini dioffset dari UTC. Ini dinyatakan dalam menit untuk mendukung zona waktu yang diimbangi dengan pecahan jam, misalnya X jam dan 15 menit. |
user_rating_count |
Jumlah total ulasan (dengan atau tanpa teks) untuk tempat ini. |
takeout |
Menentukan apakah bisnis mendukung pesan antar. |
delivery |
Menentukan apakah bisnis mendukung pesan antar. |
dine_in |
Menentukan apakah bisnis mendukung opsi tempat duduk di dalam ruangan atau di luar ruangan. |
curbside_pickup |
Menentukan apakah bisnis mendukung layanan ambil di tepi jalan. |
reservable |
Menentukan apakah tempat mendukung reservasi. |
serves_breakfast |
Menentukan apakah tempat tersebut menyajikan sarapan. |
serves_lunch |
Menentukan apakah tempat tersebut menyajikan makan siang. |
serves_dinner |
Menentukan apakah tempat tersebut menyajikan makan malam. |
serves_beer |
Menentukan apakah tempat tersebut menyajikan bir. |
serves_wine |
Menentukan apakah tempat tersebut menyajikan wine. |
serves_brunch |
Menentukan apakah tempat tersebut menyajikan sarapan siang. |
serves_vegetarian_food |
Menentukan apakah tempat tersebut menyajikan makanan vegetarian. |
outdoor_seating |
Tempat ini menyediakan tempat duduk outdoor. |
live_music |
Tempat ini menyediakan musik live. |
menu_for_children |
Tempat ini memiliki menu untuk anak-anak. |
serves_cocktails |
Tempat ini menyajikan koktail. |
serves_dessert |
Tempat ini menyajikan hidangan penutup. |
serves_coffee |
Tempat ini menyajikan kopi. |
good_for_children |
Tempatnya cocok untuk anak-anak. |
allows_dogs |
Tempat mengizinkan. |
restroom |
Tempat memiliki toilet. |
good_for_groups |
Tempat dapat menampung grup. |
good_for_watching_sports |
Tempat cocok untuk menonton acara olahraga. |
accessibility_options |
Informasi tentang opsi aksesibilitas yang ditawarkan suatu tempat. |
pure_service_area_business |
Menunjukkan apakah tempat tersebut merupakan bisnis jasa sistem panggilan murni. Bisnis jasa sistem panggilan murni adalah bisnis yang melakukan kunjungan atau pengiriman ke pelanggan secara langsung, tetapi tidak melayani pelanggan di alamat bisnisnya. Misalnya, bisnis seperti layanan kebersihan atau tukang leding. Bisnis tersebut mungkin tidak memiliki alamat atau lokasi fisik di Google Maps. |
AccessibilityOptions
Informasi tentang opsi aksesibilitas yang ditawarkan suatu tempat.
Kolom | |
---|---|
wheelchair_accessible_parking |
Tempat ini menawarkan parkir khusus pengguna kursi roda. |
wheelchair_accessible_entrance |
Tempat memiliki pintu masuk khusus pengguna kursi roda. |
wheelchair_accessible_restroom |
Tempat ini memiliki toilet khusus pengguna kursi roda. |
wheelchair_accessible_seating |
Tempat ini menyediakan tempat duduk khusus pengguna kursi roda. |
AddressComponent
Komponen terstruktur yang membentuk alamat berformat, jika informasi ini tersedia.
Kolom | |
---|---|
long_text |
Deskripsi teks lengkap atau nama komponen alamat. Misalnya, komponen alamat untuk negara Australia mungkin memiliki long_name "Australia". |
short_text |
Nama tekstual yang disingkat untuk komponen alamat, jika tersedia. Misalnya, komponen alamat untuk negara Australia dapat memiliki short_name "AU". |
types[] |
Array yang menunjukkan jenis komponen alamat. |
language_code |
Bahasa yang digunakan untuk memformat komponen ini, dalam notasi CLDR. |
AreaSummary
Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya.
Ringkasan area tempat bisnis berada yang dibuat AI.
Kolom | |
---|---|
content_blocks[] |
Blok konten yang menyusun ringkasan area. Setiap blok memiliki topik terpisah tentang area tersebut. |
flag_content_uri |
Link tempat pengguna dapat melaporkan masalah terkait ringkasan. |
Atribusi
Informasi tentang penyedia data tempat ini.
Kolom | |
---|---|
provider |
Nama penyedia data Tempat. |
provider_uri |
URI ke penyedia data Tempat. |
BusinessStatus
Status bisnis untuk tempat.
Enum | |
---|---|
BUSINESS_STATUS_UNSPECIFIED |
Nilai default. Nilai ini tidak digunakan. |
OPERATIONAL |
Tempat ini beroperasi, tetapi belum tentu buka sekarang. |
CLOSED_TEMPORARILY |
Tempat ini tutup sementara. |
CLOSED_PERMANENTLY |
Tempat ini tutup permanen. |
ContainingPlace
Info tentang tempat tempat ini berada.
Kolom | |
---|---|
name |
Nama resource tempat tempat ini berada. |
id |
ID tempat tempat tempat ini berada. |
GenerativeSummary
Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya.
Ringkasan tempat yang dibuat AI.
Kolom | |
---|---|
overview |
Ringkasan tempat. |
overview_flag_content_uri |
Link tempat pengguna dapat melaporkan masalah terkait ringkasan ringkasan. |
description |
Deskripsi mendetail tentang tempat. |
description_flag_content_uri |
Link tempat pengguna dapat melaporkan masalah dengan ringkasan deskripsi. |
references |
Referensi yang digunakan untuk membuat deskripsi ringkasan. |
GoogleMapsLinks
Link untuk memicu berbagai tindakan Google Maps.
Kolom | |
---|---|
directions_uri |
Link untuk menampilkan rute ke tempat tersebut. Link hanya mengisi lokasi tujuan dan menggunakan mode perjalanan default |
place_uri |
Link untuk menampilkan tempat ini. |
write_a_review_uri |
Link untuk menulis ulasan tempat ini. Tautan ini saat ini tidak didukung di Google Maps Seluler dan hanya berfungsi di Google Maps versi web. |
reviews_uri |
Link untuk menampilkan ulasan tempat ini. Tautan ini saat ini tidak didukung di Google Maps Seluler dan hanya berfungsi di Google Maps versi web. |
photos_uri |
Link untuk menampilkan foto tempat ini. Tautan ini saat ini tidak didukung di Google Maps Seluler dan hanya berfungsi di Google Maps versi web. |
OpeningHours
Informasi tentang jam buka tempat.
Kolom | |
---|---|
periods[] |
Periode tempat ini buka selama seminggu. Periode ini diurutkan secara kronologis, dimulai dengan hari Minggu dalam zona waktu lokal tempat. Nilai kosong (tetapi tidak tidak ada) menunjukkan tempat yang tidak pernah buka, misalnya karena ditutup sementara untuk renovasi. |
weekday_descriptions[] |
String yang dilokalkan yang menjelaskan jam buka tempat ini, satu string untuk setiap hari dalam seminggu. Akan kosong jika jam tidak diketahui atau tidak dapat dikonversi menjadi teks yang dilokalkan. Contoh: "Minggu: 18.00–06.00" |
secondary_hours_type |
String jenis yang digunakan untuk mengidentifikasi jenis jam sekunder. |
special_days[] |
Informasi terstruktur untuk hari-hari khusus yang termasuk dalam periode yang dicakup oleh jam buka yang ditampilkan. Hari khusus adalah hari yang dapat memengaruhi jam buka suatu tempat, misalnya hari Natal. Tetapkan untuk current_opening_hours dan current_secondary_opening_hours jika ada jam buka khusus. |
next_open_time |
Waktu berikutnya periode jam buka saat ini dimulai hingga 7 hari ke depan. Kolom ini hanya diisi jika periode jam buka tidak aktif pada saat permintaan ditayangkan. |
next_close_time |
Waktu berikutnya periode jam buka saat ini berakhir hingga 7 hari ke depan. Kolom ini hanya diisi jika periode jam buka aktif pada saat permintaan ditayangkan. |
open_now |
Apakah periode jam buka saat ini aktif. Untuk jam buka reguler dan jam buka saat ini, kolom ini menunjukkan apakah tempat tersebut buka. Untuk jam buka sekunder dan jam buka sekunder saat ini, kolom ini menunjukkan apakah jam buka sekunder tempat ini aktif. |
Periode
Periode tempat tetap dalam status open_now.
Titik
Titik perubahan status.
Kolom | |
---|---|
date |
Tanggal dalam zona waktu lokal untuk tempat tersebut. |
truncated |
Apakah endpoint ini terpotong atau tidak. Pemotongan terjadi saat jam sebenarnya berada di luar waktu yang ingin kita tampilkan, sehingga kita memotong jam kembali ke batas ini. Hal ini memastikan bahwa paling lama 24 * 7 jam dari tengah malam pada hari permintaan ditampilkan. |
day |
Hari dalam seminggu, sebagai bilangan bulat dalam rentang 0-6. 0 adalah Minggu, 1 adalah Senin, dst. |
hour |
Jam dalam format 24 jam. Rentang dari 0 hingga 23. |
minute |
Menit. Rentang dari 0 hingga 59. |
SecondaryHoursType
Jenis yang digunakan untuk mengidentifikasi jenis jam sekunder.
Enum | |
---|---|
SECONDARY_HOURS_TYPE_UNSPECIFIED |
Nilai default saat jenis jam sekunder tidak ditentukan. |
DRIVE_THROUGH |
Jam layanan drive-thru untuk bank, restoran, atau apotek. |
HAPPY_HOUR |
Happy hour. |
DELIVERY |
Jam pengiriman. |
TAKEOUT |
Jam pengambilan. |
KITCHEN |
Jam buka dapur. |
BREAKFAST |
Jam sarapan. |
LUNCH |
Jam makan siang. |
DINNER |
Waktu makan malam. |
BRUNCH |
Jam brunch. |
PICKUP |
Jam pengambilan. |
ACCESS |
Jam akses untuk tempat penyimpanan. |
SENIOR_HOURS |
Jam khusus untuk lansia. |
ONLINE_SERVICE_HOURS |
Jam layanan online. |
SpecialDay
Informasi terstruktur untuk hari-hari khusus yang termasuk dalam periode yang dicakup oleh jam buka yang ditampilkan. Hari khusus adalah hari yang dapat memengaruhi jam buka suatu tempat, misalnya hari Natal.
Kolom | |
---|---|
date |
Tanggal hari spesial ini. |
ParkingOptions
Informasi tentang opsi parkir untuk tempat tersebut. Tempat parkir dapat mendukung lebih dari satu opsi secara bersamaan.
Kolom | |
---|---|
free_parking_lot |
Tempat ini menawarkan tempat parkir gratis. |
paid_parking_lot |
Tempat ini menawarkan tempat parkir berbayar. |
free_street_parking |
Tempat ini menawarkan parkir di jalan gratis. |
paid_street_parking |
Tempat ini menawarkan tempat parkir di pinggir jalan berbayar. |
valet_parking |
Tempat ini menawarkan parkir valet. |
free_garage_parking |
Tempat ini menawarkan parkir garasi gratis. |
paid_garage_parking |
Tempat ini menawarkan parkir garasi berbayar. |
PaymentOptions
Opsi pembayaran yang diterima tempat tersebut.
Kolom | |
---|---|
accepts_credit_cards |
Tempat menerima kartu kredit sebagai pembayaran. |
accepts_debit_cards |
Tempat menerima kartu debit sebagai pembayaran. |
accepts_cash_only |
Tempat ini hanya menerima pembayaran tunai. Tempat dengan atribut ini mungkin masih menerima metode pembayaran lainnya. |
accepts_nfc |
Tempat menerima pembayaran dengan NFC. |
PlusCode
Plus Codes (http://plus.codes) adalah referensi lokasi dengan dua format: kode global yang menentukan persegi panjang 14mx14m (1/8000 derajat) atau lebih kecil, dan kode gabungan, yang mengganti awalan dengan lokasi referensi.
Kolom | |
---|---|
global_code |
Kode global (lengkap) tempat, seperti "9FWM33GV+HQ", yang mewakili area 1/8000 derajat x 1/8000 derajat (~14 x 14 meter). |
compound_code |
Kode gabungan tempat, seperti "33GV+HQ, Ramberg, Norway", yang berisi akhiran kode global dan mengganti awalan dengan nama entitas referensi yang diformat. |
SubDestination
Sub-tujuan adalah tempat tertentu yang terkait dengan tempat utama. Tempat ini memberikan tujuan yang lebih spesifik bagi pengguna yang menelusuri tempat besar atau kompleks, seperti bandara, taman nasional, universitas, atau stadion. Misalnya, sub-tujuan di bandara dapat mencakup terminal dan tempat parkir terkait. Sub-tujuan menampilkan ID tempat dan nama resource tempat, yang dapat digunakan dalam permintaan Place Details (New) berikutnya untuk mengambil detail yang lebih lengkap, termasuk displayName dan lokasi sub-tujuan.
Kolom | |
---|---|
name |
Nama resource sub-tujuan. |
id |
ID tempat sub-tujuan. |
Polyline
Polyline rute. Hanya mendukung polyline yang dienkode, yang dapat diteruskan sebagai string dan menyertakan kompresi dengan kehilangan data minimal. Ini adalah output default Routes API.
Kolom | |
---|---|
Kolom union polyline_type . Meng-enkapsulasi jenis polyline. Output Routes API secara default adalah encoded_polyline . polyline_type hanya dapat berupa salah satu dari hal berikut: |
|
encoded_polyline |
Polyline yang dienkode, seperti yang ditampilkan oleh Routes API secara default. Lihat alat encoder dan decoder. |
PriceLevel
Tingkat harga tempat.
Enum | |
---|---|
PRICE_LEVEL_UNSPECIFIED |
Tingkat harga tempat tidak ditentukan atau tidak diketahui. |
PRICE_LEVEL_FREE |
Tempat menyediakan layanan gratis. |
PRICE_LEVEL_INEXPENSIVE |
Tempat ini menyediakan layanan dengan harga murah. |
PRICE_LEVEL_MODERATE |
Tempat ini menyediakan layanan dengan harga sedang. |
PRICE_LEVEL_EXPENSIVE |
Tempat ini menyediakan layanan yang mahal. |
PRICE_LEVEL_VERY_EXPENSIVE |
Tempat ini menyediakan layanan yang sangat mahal. |
PriceRange
Rentang harga yang terkait dengan Tempat. end_price
dapat dibatalkan penetapannya, yang menunjukkan rentang tanpa batas atas (misalnya, "Lebih dari $100").
Referensi
Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya.
Referensi yang terkait dengan konten generatif.
Kolom | |
---|---|
reviews[] |
Ulasan yang berfungsi sebagai referensi. |
places[] |
Daftar nama resource tempat yang dirujuk. Nama ini dapat digunakan di API lain yang menerima nama resource Place. |
Tinjau
Informasi tentang ulasan tempat.
Kolom | |
---|---|
name |
Referensi yang mewakili ulasan tempat ini yang dapat digunakan untuk mencari ulasan tempat ini lagi (juga disebut nama "resource" API: |
relative_publish_time_description |
String waktu terbaru yang diformat, yang menyatakan waktu peninjauan relatif terhadap waktu saat ini dalam bentuk yang sesuai untuk bahasa dan negara. |
text |
Teks ulasan yang dilokalkan. |
original_text |
Teks ulasan dalam bahasa aslinya. |
rating |
Angka antara 1,0 dan 5,0, yang juga disebut jumlah bintang. |
author_attribution |
Penulis ulasan ini. |
publish_time |
Stempel waktu untuk ulasan. |
flag_content_uri |
Link tempat pengguna dapat melaporkan masalah terkait ulasan. |
google_maps_uri |
Link untuk menampilkan ulasan di Google Maps. |
RouteModifiers
Mengenkapsulasi serangkaian kondisi opsional yang harus dipenuhi saat menghitung rute.
Kolom | |
---|---|
avoid_tolls |
Opsional. Jika disetel ke benar, menghindari jalan tol jika memungkinkan, dengan memberikan preferensi ke rute yang tidak berisi jalan tol. Hanya berlaku untuk |
avoid_highways |
Opsional. Jika disetel ke benar (true), menghindari jalan raya jika memungkinkan, dengan memberikan preferensi ke rute yang tidak berisi jalan raya. Hanya berlaku untuk |
avoid_ferries |
Opsional. Jika disetel ke benar, menghindari feri jika memungkinkan, memberikan preferensi ke rute yang tidak berisi feri. Hanya berlaku untuk |
avoid_indoor |
Opsional. Jika disetel ke benar, menghindari navigasi di dalam ruangan jika memungkinkan, memberikan preferensi ke rute yang tidak berisi navigasi dalam ruangan. Hanya berlaku untuk |
RoutingParameters
Parameter untuk mengonfigurasi penghitungan pemilihan rute ke tempat dalam respons, baik di sepanjang rute (tempat peringkat hasil akan dipengaruhi) maupun untuk menghitung waktu perjalanan pada hasil.
Kolom | |
---|---|
origin |
Opsional. Asal pemilihan rute eksplisit yang mengganti asal yang ditentukan dalam polyline. Secara default, asal polyline digunakan. |
travel_mode |
Opsional. Mode perjalanan. |
route_modifiers |
Opsional. Pengubah rute. |
routing_preference |
Opsional. Menentukan cara menghitung ringkasan pemilihan rute. Server mencoba menggunakan preferensi pemilihan rute yang dipilih untuk menghitung rute. Preferensi pemilihan rute sesuai lalu lintas hanya tersedia untuk |
RoutingPreference
Kumpulan nilai yang menentukan faktor yang perlu dipertimbangkan saat menghitung rute.
Enum | |
---|---|
ROUTING_PREFERENCE_UNSPECIFIED |
Tidak ada preferensi pemilihan rute yang ditentukan. Default-nya adalah TRAFFIC_UNAWARE . |
TRAFFIC_UNAWARE |
Menghitung rute tanpa mempertimbangkan kondisi lalu lintas langsung. Cocok jika kondisi lalu lintas tidak penting atau tidak berlaku. Penggunaan nilai ini menghasilkan latensi terendah. Catatan: Untuk DRIVE dan TWO_WHEELER , rute dan durasi yang dipilih didasarkan pada jaringan jalan dan kondisi lalu lintas rata-rata tanpa memperhitungkan waktu, bukan kondisi jalan saat ini. Akibatnya, rute tersebut mungkin mencakup jalan yang ditutup sementara. Hasil untuk permintaan tertentu dapat berubah dari waktu ke waktu karena perubahan pada jaringan jalan, kondisi lalu lintas rata-rata yang diperbarui, dan sifat distribusi layanan. Hasilnya juga dapat bervariasi di antara rute yang hampir setara di semua waktu atau frekuensi. |
TRAFFIC_AWARE |
Menghitung rute dengan mempertimbangkan kondisi lalu lintas real-time. Berbeda dengan TRAFFIC_AWARE_OPTIMAL , beberapa pengoptimalan diterapkan untuk mengurangi latensi secara signifikan. |
TRAFFIC_AWARE_OPTIMAL |
Menghitung rute dengan mempertimbangkan kondisi lalu lintas real-time, tanpa menerapkan sebagian besar pengoptimalan performa. Penggunaan nilai ini akan menghasilkan latensi tertinggi. |
RoutingSummary
Durasi dan jarak dari asal pemilihan rute ke suatu tempat dalam respons, dan segmen kedua dari tempat tersebut ke tujuan, jika diminta. Catatan: Menambahkan routingSummaries
di mask kolom tanpa menyertakan parameter routingParameters.origin
atau parameter searchAlongRouteParameters.polyline.encodedPolyline
dalam permintaan akan menyebabkan error.
Kolom | |
---|---|
legs[] |
Segmen perjalanan. Saat Anda menghitung durasi dan jarak perjalanan dari asal yang ditetapkan, |
directions_uri |
Link untuk menampilkan rute di Google Maps menggunakan titik jalan dari ringkasan pemilihan rute yang diberikan. Rute yang dihasilkan oleh link ini tidak dijamin sama dengan rute yang digunakan untuk membuat ringkasan perutean. Link menggunakan informasi yang diberikan dalam permintaan, dari kolom termasuk |
Kaki
Segmen adalah satu bagian perjalanan dari satu lokasi ke lokasi lainnya.
Kolom | |
---|---|
duration |
Waktu yang diperlukan untuk menyelesaikan bagian perjalanan ini. |
distance_meters |
Jarak segmen perjalanan ini. |
SearchNearbyRequest
Meminta proto untuk Penelusuran di Sekitar.
Kolom | |
---|---|
language_code |
Detail tempat akan ditampilkan dengan bahasa pilihan jika tersedia. Jika kode bahasa tidak ditentukan atau tidak dikenali, detail tempat dalam bahasa apa pun dapat ditampilkan, dengan preferensi untuk bahasa Inggris jika detail tersebut ada. Daftar bahasa yang didukung saat ini: https://developers.google.com/maps/faq#languagesupport. |
region_code |
Kode negara/wilayah Unicode (CLDR) lokasi asal permintaan. Parameter ini digunakan untuk menampilkan detail tempat, seperti nama tempat khusus wilayah, jika tersedia. Parameter ini dapat memengaruhi hasil berdasarkan hukum yang berlaku. Untuk informasi selengkapnya, lihat https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. Perhatikan bahwa kode wilayah 3 digit saat ini tidak didukung. |
included_types[] |
Jenis Tempat yang disertakan (misalnya, "restaurant" atau "gas_station") dari https://developers.google.com/maps/documentation/places/web-service/place-types. Maksimal 50 jenis dari Tabel A dapat ditentukan. Jika ada jenis yang bertentangan, yaitu jenis yang muncul di included_types dan excluded_types, error INVALID_ARGUMENT akan ditampilkan. Jika jenis Tempat ditentukan dengan beberapa batasan jenis, hanya tempat yang memenuhi semua batasan yang akan ditampilkan. Misalnya, jika kita memiliki {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, tempat yang ditampilkan akan menyediakan layanan terkait "restoran", tetapi tidak beroperasi terutama sebagai "restoran". |
excluded_types[] |
Jenis Tempat yang dikecualikan (misalnya, "restaurant" atau "gas_station") dari https://developers.google.com/maps/documentation/places/web-service/place-types. Maksimal 50 jenis dari Tabel A dapat ditentukan. Jika klien memberikan included_types (misalnya restoran) dan excluded_types (misalnya kafe), respons harus menyertakan tempat yang merupakan restoran, tetapi bukan kafe. Responsnya mencakup tempat yang cocok dengan setidaknya salah satu included_types dan tidak ada excluded_types. Jika ada jenis yang bertentangan, yaitu jenis yang muncul di included_types dan excluded_types, error INVALID_ARGUMENT akan ditampilkan. Jika jenis Tempat ditentukan dengan beberapa batasan jenis, hanya tempat yang memenuhi semua batasan yang akan ditampilkan. Misalnya, jika kita memiliki {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, tempat yang ditampilkan akan menyediakan layanan terkait "restoran", tetapi tidak beroperasi terutama sebagai "restoran". |
included_primary_types[] |
Menyertakan jenis Tempat utama (misalnya "restaurant" atau "gas_station") dari https://developers.google.com/maps/documentation/places/web-service/place-types. Tempat hanya dapat memiliki satu jenis utama dari tabel jenis yang didukung yang terkait dengannya. Maksimal 50 jenis dari Tabel A dapat ditentukan. Jika ada jenis utama yang bertentangan, yaitu jenis yang muncul di included_primary_types dan excluded_primary_types, error INVALID_ARGUMENT akan ditampilkan. Jika jenis Tempat ditentukan dengan beberapa batasan jenis, hanya tempat yang memenuhi semua batasan yang akan ditampilkan. Misalnya, jika kita memiliki {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, tempat yang ditampilkan akan menyediakan layanan terkait "restoran", tetapi tidak beroperasi terutama sebagai "restoran". |
excluded_primary_types[] |
Jenis Tempat utama yang dikecualikan (misalnya "restaurant" atau "gas_station") dari https://developers.google.com/maps/documentation/places/web-service/place-types. Maksimal 50 jenis dari Tabel A dapat ditentukan. Jika ada jenis utama yang bertentangan, yaitu jenis yang muncul di included_primary_types dan excluded_primary_types, error INVALID_ARGUMENT akan ditampilkan. Jika jenis Tempat ditentukan dengan beberapa batasan jenis, hanya tempat yang memenuhi semua batasan yang akan ditampilkan. Misalnya, jika kita memiliki {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, tempat yang ditampilkan akan menyediakan layanan terkait "restoran", tetapi tidak beroperasi terutama sebagai "restoran". |
max_result_count |
Jumlah hasil maksimum yang akan ditampilkan. Nilainya harus antara 1 dan 20 (default), inklusif. Jika tidak ditetapkan, angka tersebut akan kembali ke batas atas. Jika angka ditetapkan ke negatif atau melebihi batas atas, error INVALID_ARGUMENT akan ditampilkan. |
location_restriction |
Wajib. Wilayah yang akan ditelusuri. |
rank_preference |
Cara hasil akan diberi peringkat dalam respons. |
routing_parameters |
Opsional. Parameter yang memengaruhi pemilihan rute ke hasil penelusuran. |
LocationRestriction
Wilayah yang akan ditelusuri.
Kolom | |
---|---|
Kolom union
|
|
circle |
Lingkaran yang ditentukan oleh titik tengah dan radius. |
RankPreference
Cara hasil akan diberi peringkat dalam respons.
Enum | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
Nilai RankPreference tidak ditetapkan. Secara default, akan menggunakan peringkat berdasarkan POPULARITAS. |
DISTANCE |
Mengurutkan hasil menurut jarak. |
POPULARITY |
Memberi peringkat hasil berdasarkan popularitas. |
SearchNearbyResponse
Proto respons untuk Penelusuran di Sekitar.
Kolom | |
---|---|
places[] |
Daftar tempat yang memenuhi persyaratan pengguna seperti jenis tempat, jumlah tempat, dan batasan lokasi tertentu. |
routing_summaries[] |
Daftar ringkasan pemilihan rute dengan setiap entri dikaitkan ke tempat yang sesuai dalam indeks yang sama di kolom |
SearchTextRequest
Meminta proto untuk SearchText.
Kolom | |
---|---|
text_query |
Wajib. Kueri teks untuk penelusuran tekstual. |
language_code |
Detail tempat akan ditampilkan dengan bahasa pilihan jika tersedia. Jika kode bahasa tidak ditentukan atau tidak dikenali, detail tempat dalam bahasa apa pun dapat ditampilkan, dengan preferensi untuk bahasa Inggris jika detail tersebut ada. Daftar bahasa yang didukung saat ini: https://developers.google.com/maps/faq#languagesupport. |
region_code |
Kode negara/wilayah Unicode (CLDR) lokasi asal permintaan. Parameter ini digunakan untuk menampilkan detail tempat, seperti nama tempat khusus wilayah, jika tersedia. Parameter ini dapat memengaruhi hasil berdasarkan hukum yang berlaku. Untuk informasi selengkapnya, lihat https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. Perhatikan bahwa kode wilayah 3 digit saat ini tidak didukung. |
rank_preference |
Cara hasil akan diberi peringkat dalam respons. |
included_type |
Jenis tempat yang diminta. Daftar lengkap jenis yang didukung: https://developers.google.com/maps/documentation/places/web-service/place-types. Hanya mendukung satu jenis yang disertakan. |
open_now |
Digunakan untuk membatasi penelusuran ke tempat yang saat ini buka. Default-nya adalah salah. |
min_rating |
Memfilter hasil yang rata-rata rating penggunanya jauh lebih rendah dari batas ini. Nilai yang valid harus berupa float antara 0 dan 5 (inklusif) dengan ritme 0,5, yaitu [0, 0,5, 1,0, ... , 5,0] inklusif. Rating input akan dibulatkan ke atas ke 0,5 terdekat(plafon). Misalnya, rating 0,6 akan menghapus semua hasil dengan rating kurang dari 1,0. |
max_result_count |
Tidak digunakan lagi: Gunakan Jumlah maksimum hasil per halaman yang dapat ditampilkan. Jika jumlah hasil yang tersedia lebih besar dari Jika |
page_size |
Opsional. Jumlah maksimum hasil per halaman yang dapat ditampilkan. Jika jumlah hasil yang tersedia lebih besar dari Jika |
page_token |
Opsional. Token halaman, diterima dari panggilan TextSearch sebelumnya. Berikan ini untuk mengambil halaman berikutnya. Saat melakukan penomoran halaman, semua parameter selain |
price_levels[] |
Digunakan untuk membatasi penelusuran ke tempat yang ditandai sebagai tingkat harga tertentu. Pengguna dapat memilih kombinasi tingkat harga apa pun. Setelan defaultnya adalah memilih semua tingkat harga. |
strict_type_filtering |
Digunakan untuk menetapkan pemfilteran jenis yang ketat untuk included_type. Jika disetel ke true, hanya hasil dari jenis yang sama yang akan ditampilkan. Defaultnya adalah salah (false). |
location_bias |
Wilayah yang akan ditelusuri. Lokasi ini berfungsi sebagai bias yang berarti hasil di sekitar lokasi tertentu mungkin ditampilkan. Tidak dapat ditetapkan bersama dengan location_restriction. |
location_restriction |
Wilayah yang akan ditelusuri. Lokasi ini berfungsi sebagai batasan yang berarti hasil di luar lokasi tertentu tidak akan ditampilkan. Tidak dapat ditetapkan bersama dengan location_bias. |
ev_options |
Opsional. Menetapkan opsi EV yang dapat ditelusuri dari permintaan penelusuran tempat. |
routing_parameters |
Opsional. Parameter tambahan untuk pemilihan rute ke hasil. |
search_along_route_parameters |
Opsional. Proto parameter tambahan untuk menelusuri di sepanjang rute. |
include_pure_service_area_businesses |
Opsional. Sertakan bisnis jasa sistem panggilan murni jika kolom ditetapkan ke benar. Bisnis jasa sistem panggilan murni adalah bisnis yang melakukan kunjungan atau pengiriman ke pelanggan secara langsung, tetapi tidak melayani pelanggan di alamat bisnisnya. Misalnya, bisnis seperti layanan kebersihan atau tukang leding. Bisnis tersebut tidak memiliki alamat atau lokasi fisik di Google Maps. Places tidak akan menampilkan kolom termasuk |
EVOptions
Opsi Kendaraan Listrik Umum yang dapat ditelusuri dari permintaan penelusuran tempat.
Kolom | |
---|---|
minimum_charging_rate_kw |
Opsional. Kecepatan pengisian daya minimum yang diperlukan dalam kilowatt. Tempat dengan tarif pengisian daya kurang dari tarif yang ditentukan akan difilter. |
connector_types[] |
Opsional. Daftar jenis konektor EV yang diinginkan. Tempat yang tidak mendukung salah satu jenis konektor yang tercantum akan difilter. |
LocationBias
Wilayah yang akan ditelusuri. Lokasi ini berfungsi sebagai bias yang berarti hasil di sekitar lokasi tertentu mungkin ditampilkan.
Kolom | |
---|---|
Kolom union
|
|
rectangle |
Kotak persegi panjang yang ditentukan oleh sudut timur laut dan barat daya. |
circle |
Lingkaran yang ditentukan oleh titik tengah dan radius. |
LocationRestriction
Wilayah yang akan ditelusuri. Lokasi ini berfungsi sebagai batasan yang berarti hasil di luar lokasi tertentu tidak akan ditampilkan.
Kolom | |
---|---|
Kolom union
|
|
rectangle |
Kotak persegi panjang yang ditentukan oleh sudut timur laut dan barat daya. |
RankPreference
Cara hasil akan diberi peringkat dalam respons.
Enum | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
Untuk kueri kategori seperti "Restoran di Jakarta", RELEVANSI adalah setelan default. Untuk kueri non-kategoris seperti "Mountain View, CA", sebaiknya Anda membiarkan rankPreference tidak ditetapkan. |
DISTANCE |
Mengurutkan hasil menurut jarak. |
RELEVANCE |
Mengurutkan hasil berdasarkan relevansi. Urutan pengurutan ditentukan oleh tumpukan peringkat normal. |
SearchAlongRouteParameters
Menentukan polyline yang telah dihitung sebelumnya dari Routes API yang menentukan rute yang akan ditelusuri. Menelusuri sepanjang rute mirip dengan menggunakan opsi permintaan locationBias
atau locationRestriction
untuk membiaskan hasil penelusuran. Namun, meskipun opsi locationBias
dan locationRestriction
memungkinkan Anda menentukan wilayah untuk membiaskan hasil penelusuran, opsi ini memungkinkan Anda membiaskan hasil di sepanjang rute perjalanan.
Hasil tidak dijamin berada di sepanjang rute yang diberikan, tetapi diberi peringkat dalam area penelusuran yang ditentukan oleh polyline dan, secara opsional, oleh locationBias
atau locationRestriction
berdasarkan waktu pengalihan minimal dari asal ke tujuan. Hasilnya mungkin berada di sepanjang rute alternatif, terutama jika polyline yang diberikan tidak menentukan rute yang optimal dari asal ke tujuan.
Kolom | |
---|---|
polyline |
Wajib. Polyline rute. |
SearchTextResponse
Proto respons untuk SearchText.
Kolom | |
---|---|
places[] |
Daftar tempat yang memenuhi kriteria penelusuran teks pengguna. |
routing_summaries[] |
Daftar ringkasan pemilihan rute dengan setiap entri dikaitkan ke tempat yang sesuai dalam indeks yang sama di kolom |
contextual_contents[] |
Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya. Daftar konten kontekstual dengan setiap entri yang dikaitkan ke tempat yang sesuai dalam indeks yang sama di kolom tempat. Konten yang relevan dengan |
next_page_token |
Token yang dapat dikirim sebagai |
search_uri |
Link memungkinkan pengguna melakukan penelusuran dengan kueri teks yang sama seperti yang ditentukan dalam permintaan di Google Maps. |
TravelMode
Opsi mode perjalanan. Opsi ini dipetakan ke opsi yang ditawarkan Routes API.
Enum | |
---|---|
TRAVEL_MODE_UNSPECIFIED |
Tidak ada mode perjalanan yang ditentukan. Default-nya adalah DRIVE . |
DRIVE |
Bepergian dengan mobil penumpang. |
BICYCLE |
Bepergian dengan sepeda. Tidak didukung dengan search_along_route_parameters . |
WALK |
Perjalanan dengan berjalan kaki. Tidak didukung dengan search_along_route_parameters . |
TWO_WHEELER |
Semua jenis kendaraan roda dua bermotor seperti skuter dan sepeda motor. Perhatikan bahwa ini berbeda dengan mode perjalanan BICYCLE yang mencakup transportasi yang digerakkan manusia. Tidak didukung dengan search_along_route_parameters . Hanya didukung di negara yang tercantum di Negara dan wilayah yang didukung untuk kendaraan roda dua. |