Package google.maps.places.v1

Indeks

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

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

Menampilkan prediksi untuk input yang diberikan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

Mendapatkan media foto dengan string referensi foto.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

Mendapatkan detail tempat berdasarkan nama resource-nya, yang merupakan string dalam format places/{place_id}.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
SearchNearby

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

Menelusuri tempat di dekat lokasi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

Penelusuran tempat berbasis kueri teks.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform

AddressDescriptor

Deskripsi relasional lokasi. Mencakup kumpulan penanda terdekat yang diberi peringkat dan area penampung yang akurat serta hubungannya dengan lokasi target.

Kolom
landmarks[]

Landmark

Daftar tempat terkenal di sekitar yang diberi peringkat. Penanda terdekat dan yang paling mudah dikenali akan diberi peringkat pertama.

areas[]

Area

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

string

Nama resource area.

place_id

string

ID tempat area.

display_name

LocalizedText

Nama tampilan area.

containment

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

string

Nama resource penanda.

place_id

string

ID tempat penanda.

display_name

LocalizedText

Nama tampilan penanda.

types[]

string

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

SpatialRelationship

Menentukan hubungan spasial antara lokasi target dan penanda.

straight_line_distance_meters

float

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.

travel_distance_meters

float

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.

Kolom
display_name

string

Nama penulis Photo atau Review.

uri

string

URI penulis Photo atau Review.

photo_uri

string

URI foto profil penulis Photo atau Review.

AutocompletePlacesRequest

Meminta proto untuk AutocompletePlaces.

Kolom
input

string

Wajib. String teks yang akan ditelusuri.

location_bias

LocationBias

Opsional. Membiaskan hasil ke lokasi yang ditentukan.

Maksimal satu dari location_bias atau location_restriction harus ditetapkan. Jika tidak ada yang ditetapkan, hasilnya akan bias berdasarkan alamat IP, yang berarti alamat IP akan dipetakan ke lokasi yang tidak akurat dan digunakan sebagai sinyal bias.

location_restriction

LocationRestriction

Opsional. Membatasi hasil ke lokasi yang ditentukan.

Maksimal satu dari location_bias atau location_restriction harus ditetapkan. Jika tidak ada yang ditetapkan, hasilnya akan bias berdasarkan alamat IP, yang berarti alamat IP akan dipetakan ke lokasi yang tidak akurat dan digunakan sebagai sinyal bias.

included_primary_types[]

string

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 (regions), atau hanya (cities). Tempat hanya ditampilkan jika jenis utamanya disertakan dalam daftar ini. Maksimal 5 nilai dapat ditentukan. Jika tidak ada jenis yang ditentukan, semua jenis Tempat akan ditampilkan.

included_region_codes[]

string

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 location_restriction dan included_region_codes ditetapkan, hasilnya akan berada di area persimpangan.

language_code

string

Opsional. Bahasa yang digunakan untuk menampilkan hasil. Setelan defaultnya adalah en-US. Hasilnya mungkin dalam bahasa campuran jika bahasa yang digunakan di input berbeda dengan language_code atau jika Tempat yang ditampilkan tidak memiliki terjemahan dari bahasa lokal ke language_code.

region_code

string

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 region_code_restriction.

origin

LatLng

Opsional. Titik asal tempat jarak geodesik dihitung ke tujuan (ditampilkan sebagai distance_meters). Jika nilai ini dihilangkan, jarak geodesik tidak akan ditampilkan.

input_offset

int32

Opsional. Offset karakter Unicode berbasis nol dari input yang menunjukkan posisi kursor di input. Posisi kursor dapat memengaruhi prediksi yang ditampilkan.

Jika kosong, setelan defaultnya adalah panjang input.

include_query_predictions

bool

Opsional. Jika benar, respons akan menyertakan prediksi Place dan kueri. Jika tidak, respons hanya akan menampilkan prediksi Tempat.

session_token

string

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 session_token dihilangkan, atau jika Anda menggunakan kembali token sesi, sesi tersebut dikenai biaya seolah-olah tidak ada token sesi yang diberikan (setiap permintaan ditagih secara terpisah).

Sebaiknya ikuti panduan berikut:

  • Gunakan token sesi untuk semua panggilan Place Autocomplete.
  • Buat token baru untuk setiap sesi. Sebaiknya gunakan UUID versi 4.
  • Pastikan kredensial yang digunakan untuk semua permintaan Place Autocomplete, Place Details, dan Address Validation dalam sesi berasal dari project Konsol Cloud yang sama.
  • Pastikan untuk meneruskan token sesi yang unik untuk setiap sesi baru. Jika menggunakan token yang sama untuk lebih dari satu sesi, setiap permintaan akan ditagih satu per satu.
include_pure_service_area_businesses

bool

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 location, plus_code, dan kolom terkait lokasi lainnya untuk bisnis ini.

LocationBias

Wilayah yang akan ditelusuri. Hasilnya mungkin bias di sekitar wilayah yang ditentukan.

Kolom

Kolom union type.

type hanya dapat berupa salah satu dari hal berikut:

rectangle

Viewport

Area pandang yang ditentukan oleh sudut timur laut dan barat daya.

circle

Circle

Lingkaran yang ditentukan oleh titik tengah dan radius.

LocationRestriction

Wilayah yang akan ditelusuri. Hasil akan dibatasi pada wilayah yang ditentukan.

Kolom

Kolom union type.

type hanya dapat berupa salah satu dari hal berikut:

rectangle

Viewport

Area pandang yang ditentukan oleh sudut timur laut dan barat daya.

circle

Circle

Lingkaran yang ditentukan oleh titik tengah dan radius.

AutocompletePlacesResponse

Proto respons untuk AutocompletePlaces.

Kolom
suggestions[]

Suggestion

Berisi daftar saran, yang diurutkan dalam urutan relevansi menurun.

Saran

Hasil saran Autocomplete.

Kolom

Kolom union kind.

kind hanya dapat berupa salah satu dari hal berikut:

place_prediction

PlacePrediction

Prediksi untuk Tempat.

query_prediction

QueryPrediction

Prediksi untuk kueri.

FormattableText

Teks yang mewakili Tempat atau prediksi kueri. Teks dapat digunakan apa adanya atau diformat.

Kolom
text

string

Teks yang dapat digunakan apa adanya atau diformat dengan matches.

matches[]

StringRange

Daftar rentang string yang mengidentifikasi tempat permintaan input dicocokkan di text. Rentang dapat digunakan untuk memformat bagian tertentu dari text. Substring mungkin tidak sama persis dengan input jika pencocokan ditentukan oleh kriteria selain pencocokan string (misalnya, koreksi ejaan atau transliterasi).

Nilai ini adalah offset karakter Unicode dari text. Rentang dijamin akan diurutkan dalam nilai offset yang meningkat.

PlacePrediction

Hasil prediksi untuk prediksi Place Autocomplete.

Kolom
place

string

Nama resource Tempat yang disarankan. Nama ini dapat digunakan di API lain yang menerima nama Tempat.

place_id

string

ID unik Tempat yang disarankan. ID ini dapat digunakan di API lain yang menerima ID Tempat.

text

FormattableText

Berisi nama yang dapat dibaca manusia untuk hasil yang ditampilkan. Untuk hasil tempat, ini biasanya adalah nama dan alamat bisnis.

text direkomendasikan untuk developer yang ingin menampilkan satu elemen UI. Developer yang ingin menampilkan dua elemen UI terpisah, tetapi terkait, sebaiknya menggunakan structured_format. Keduanya adalah dua cara berbeda untuk merepresentasikan prediksi Tempat. Pengguna tidak boleh mencoba mengurai structured_format menjadi text atau sebaliknya.

Teks ini mungkin berbeda dengan display_name yang ditampilkan oleh GetPlace.

Mungkin dalam bahasa campuran jika permintaan input dan language_code dalam bahasa yang berbeda atau jika Tempat tidak memiliki terjemahan dari bahasa lokal ke language_code.

structured_format

StructuredFormat

Perincian prediksi Tempat menjadi teks utama yang berisi nama Tempat dan teks sekunder yang berisi fitur disambiguasi tambahan (seperti kota atau wilayah).

structured_format direkomendasikan untuk developer yang ingin menampilkan dua elemen UI terpisah, tetapi terkait. Developer yang ingin menampilkan satu elemen UI sebaiknya menggunakan text. Keduanya adalah dua cara berbeda untuk merepresentasikan prediksi Tempat. Pengguna tidak boleh mencoba mengurai structured_format menjadi text atau sebaliknya.

types[]

string

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

int32

Panjang geodesi dalam meter dari origin jika origin ditentukan. Prediksi tertentu seperti rute mungkin tidak mengisi kolom ini.

QueryPrediction

Hasil prediksi untuk prediksi Autocomplete Kueri.

Kolom
text

FormattableText

Teks yang diprediksi. Teks ini tidak mewakili Tempat, tetapi merupakan kueri teks yang dapat digunakan di endpoint penelusuran (misalnya, Text Search).

text direkomendasikan untuk developer yang ingin menampilkan satu elemen UI. Developer yang ingin menampilkan dua elemen UI terpisah, tetapi terkait, sebaiknya menggunakan structured_format. Keduanya adalah dua cara berbeda untuk merepresentasikan prediksi kueri. Pengguna tidak boleh mencoba mengurai structured_format menjadi text atau sebaliknya.

Mungkin dalam bahasa campuran jika permintaan input dan language_code dalam bahasa yang berbeda atau jika bagian dari kueri tidak memiliki terjemahan dari bahasa lokal ke language_code.

structured_format

StructuredFormat

Perincian prediksi kueri menjadi teks utama yang berisi kueri dan teks sekunder yang berisi fitur disambiguasi tambahan (seperti kota atau wilayah).

structured_format direkomendasikan untuk developer yang ingin menampilkan dua elemen UI terpisah, tetapi terkait. Developer yang ingin menampilkan satu elemen UI sebaiknya menggunakan text. Keduanya adalah dua cara berbeda untuk merepresentasikan prediksi kueri. Pengguna tidak boleh mencoba mengurai structured_format menjadi text atau sebaliknya.

StringRange

Mengidentifikasi substring dalam teks tertentu.

Kolom
start_offset

int32

Offset berbasis nol dari karakter Unicode pertama string (inklusif).

end_offset

int32

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

FormattableText

Mewakili nama Tempat atau kueri.

secondary_text

FormattableText

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

LatLng

Wajib. Lintang dan bujur tengah.

Rentang lintang harus berada dalam [-90.0, 90.0]. Rentang bujur harus berada dalam [-180.0, 180.0].

radius

double

Wajib. Radius diukur dalam meter. Radius harus berada dalam [0.0, 50000.0].

ContentBlock

Blok konten yang dapat ditayangkan satu per satu.

Kolom
topic

string

Topik konten, misalnya "ringkasan" atau "restoran".

content

LocalizedText

Konten yang terkait dengan topik.

references

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[]

Review

Daftar ulasan tentang tempat ini, yang kontekstual dengan kueri tempat.

photos[]

Photo

Informasi (termasuk referensi) tentang foto tempat ini, yang kontekstual dengan kueri tempat.

justifications[]

Justification

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 justification.

justification hanya dapat berupa salah satu dari hal berikut:

review_justification

ReviewJustification

Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya.

business_availability_attributes_justification

BusinessAvailabilityAttributesJustification

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

bool

Apakah tempat menyediakan opsi bawa pulang.

delivery

bool

Apakah tempat ini menyediakan layanan pesan antar.

dine_in

bool

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

HighlightedText

review

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

string

highlighted_text_ranges[]

HighlightedTextRange

Daftar rentang teks yang ditandai.

HighlightedTextRange

Rentang teks yang ditandai.

Kolom
start_index

int32

end_index

int32

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

int32

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[]

ConnectorAggregation

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

EVConnectorType

Jenis konektor agregasi ini.

max_charge_rate_kw

double

Kecepatan pengisian daya maksimum statis dalam kw dari setiap konektor dalam agregasi.

count

int32

Jumlah konektor dalam agregasi ini.

availability_last_update_time

Timestamp

Stempel waktu saat informasi ketersediaan konektor dalam agregasi ini terakhir diperbarui.

available_count

int32

Jumlah konektor dalam agregasi ini yang saat ini tersedia.

out_of_service_count

int32

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[]

FuelPrice

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.

Kolom
type

FuelType

Jenis bahan bakar.

price

Money

Harga bahan bakar.

update_time

Timestamp

Waktu harga bahan bakar terakhir diperbarui.

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

string

Wajib. Nama resource media foto dalam format: places/{place_id}/photos/{photo_reference}/media.

Nama resource foto seperti yang ditampilkan di kolom photos.name objek Place memiliki format places/{place_id}/photos/{photo_reference}. Anda harus menambahkan /media di akhir resource foto untuk mendapatkan nama resource media foto.

max_width_px

int32

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

int32

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

bool

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

string

Wajib. Nama resource tempat, dalam format places/{place_id}.

language_code

string

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

string

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

string

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 session_token dihilangkan, atau jika Anda menggunakan kembali token sesi, sesi tersebut dikenai biaya seolah-olah tidak ada token sesi yang diberikan (setiap permintaan ditagih secara terpisah).

Sebaiknya ikuti panduan berikut:

  • Gunakan token sesi untuk semua panggilan Place Autocomplete.
  • Buat token baru untuk setiap sesi. Sebaiknya gunakan UUID versi 4.
  • Pastikan kredensial yang digunakan untuk semua permintaan Place Autocomplete, Place Details, dan Address Validation dalam sesi berasal dari project Konsol Cloud yang sama.
  • Pastikan untuk meneruskan token sesi yang unik untuk setiap sesi baru. Jika menggunakan token yang sama untuk lebih dari satu sesi, setiap permintaan akan ditagih satu per satu.

Foto

Informasi tentang foto suatu tempat.

Kolom
name

string

ID. Referensi yang mewakili foto tempat ini yang dapat digunakan untuk mencari foto tempat ini lagi (juga disebut nama "resource" API: places/{place_id}/photos/{photo}).

width_px

int32

Lebar maksimum yang tersedia, dalam piksel.

height_px

int32

Tinggi maksimum yang tersedia, dalam piksel.

author_attributions[]

AuthorAttribution

Penulis foto ini.

flag_content_uri

string

Link tempat pengguna dapat melaporkan masalah pada foto.

google_maps_uri

string

Link untuk menampilkan foto di Google Maps.

PhotoMedia

Media foto dari Places API.

Kolom
name

string

Nama resource media foto dalam format: places/{place_id}/photos/{photo_reference}/media.

photo_uri

string

URI berumur pendek yang dapat digunakan untuk merender foto.

Tempat

Semua informasi yang mewakili Tempat.

Kolom
name

string

Nama resource Tempat ini, dalam format places/{place_id}. Dapat digunakan untuk mencari Tempat.

id

string

ID unik tempat.

display_name

LocalizedText

Nama tempat yang dilokalkan, cocok sebagai deskripsi singkat yang dapat dibaca manusia. Misalnya, "Google Sydney", "Starbucks", "Pyrmont", dll.

types[]

string

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

string

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

LocalizedText

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

string

Nomor telepon yang dapat dibaca manusia untuk tempat tersebut, dalam format nasional.

international_phone_number

string

Nomor telepon yang dapat dibaca manusia untuk tempat tersebut, dalam format internasional.

formatted_address

string

Alamat lengkap yang dapat dibaca manusia untuk tempat ini.

short_formatted_address

string

Alamat singkat yang dapat dibaca manusia untuk tempat ini.

address_components[]

AddressComponent

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

PlusCode

Plus Codes lintang/bujur lokasi tempat.

location

LatLng

Posisi tempat ini.

viewport

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

double

Rating antara 1,0 dan 5,0, berdasarkan ulasan pengguna tentang tempat ini.

google_maps_uri

string

URL yang memberikan informasi selengkapnya tentang tempat ini.

website_uri

string

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[]

Review

Daftar ulasan tentang tempat ini, diurutkan menurut relevansi. Maksimum 5 ulasan dapat ditampilkan.

regular_opening_hours

OpeningHours

Jam operasional reguler. Perhatikan bahwa jika tempat selalu buka (24 jam), kolom close tidak akan ditetapkan. Klien dapat mengandalkan selalu buka (24 jam) yang direpresentasikan sebagai jangka waktu [open][google.maps.places.v1.Place.OpeningHours.Period.open] yang berisi [day][Point.day] dengan nilai 0, [hour][Point.hour] dengan nilai 0, dan [minute][Point.minute] dengan nilai 0.

time_zone

TimeZone

Zona waktu Database Zona Waktu IANA. Misalnya "America/New_York".

photos[]

Photo

Informasi (termasuk referensi) tentang foto tempat ini. Maksimum 10 foto dapat ditampilkan.

adr_format_address

string

Alamat tempat dalam microformat adr: http://microformats.org/wiki/adr.

business_status

BusinessStatus

Status bisnis untuk tempat.

price_level

PriceLevel

Tingkat harga tempat.

attributions[]

Attribution

Kumpulan penyedia data yang harus ditampilkan dengan hasil ini.

icon_mask_base_uri

string

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

string

Warna latar belakang untuk icon_mask dalam format heksadesimal, misalnya #909CE1.

current_opening_hours

OpeningHours

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[]

OpeningHours

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[]

OpeningHours

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

LocalizedText

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

PaymentOptions

Opsi pembayaran yang diterima tempat tersebut. Jika data opsi pembayaran tidak tersedia, kolom opsi pembayaran tidak akan ditetapkan.

parking_options

ParkingOptions

Opsi parkir yang disediakan oleh tempat.

sub_destinations[]

SubDestination

Daftar sub-tujuan yang terkait dengan tempat.

fuel_options

FuelOptions

Informasi terbaru tentang opsi bahan bakar di SPBU. Informasi ini diperbarui secara berkala.

ev_charge_options

EVChargeOptions

Informasi tentang opsi pengisian daya kendaraan listrik.

generative_summary

GenerativeSummary

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

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.

containing_places[]

ContainingPlace

Daftar tempat tempat lokasi saat ini berada.

address_descriptor

AddressDescriptor

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.

price_range

PriceRange

Rentang harga yang terkait dengan Tempat.

utc_offset_minutes

int32

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

int32

Jumlah total ulasan (dengan atau tanpa teks) untuk tempat ini.

takeout

bool

Menentukan apakah bisnis mendukung pesan antar.

delivery

bool

Menentukan apakah bisnis mendukung pesan antar.

dine_in

bool

Menentukan apakah bisnis mendukung opsi tempat duduk di dalam ruangan atau di luar ruangan.

curbside_pickup

bool

Menentukan apakah bisnis mendukung layanan ambil di tepi jalan.

reservable

bool

Menentukan apakah tempat mendukung reservasi.

serves_breakfast

bool

Menentukan apakah tempat tersebut menyajikan sarapan.

serves_lunch

bool

Menentukan apakah tempat tersebut menyajikan makan siang.

serves_dinner

bool

Menentukan apakah tempat tersebut menyajikan makan malam.

serves_beer

bool

Menentukan apakah tempat tersebut menyajikan bir.

serves_wine

bool

Menentukan apakah tempat tersebut menyajikan wine.

serves_brunch

bool

Menentukan apakah tempat tersebut menyajikan sarapan siang.

serves_vegetarian_food

bool

Menentukan apakah tempat tersebut menyajikan makanan vegetarian.

outdoor_seating

bool

Tempat ini menyediakan tempat duduk outdoor.

live_music

bool

Tempat ini menyediakan musik live.

menu_for_children

bool

Tempat ini memiliki menu untuk anak-anak.

serves_cocktails

bool

Tempat ini menyajikan koktail.

serves_dessert

bool

Tempat ini menyajikan hidangan penutup.

serves_coffee

bool

Tempat ini menyajikan kopi.

good_for_children

bool

Tempatnya cocok untuk anak-anak.

allows_dogs

bool

Tempat mengizinkan.

restroom

bool

Tempat memiliki toilet.

good_for_groups

bool

Tempat dapat menampung grup.

good_for_watching_sports

bool

Tempat cocok untuk menonton acara olahraga.

accessibility_options

AccessibilityOptions

Informasi tentang opsi aksesibilitas yang ditawarkan suatu tempat.

pure_service_area_business

bool

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

bool

Tempat ini menawarkan parkir khusus pengguna kursi roda.

wheelchair_accessible_entrance

bool

Tempat memiliki pintu masuk khusus pengguna kursi roda.

wheelchair_accessible_restroom

bool

Tempat ini memiliki toilet khusus pengguna kursi roda.

wheelchair_accessible_seating

bool

Tempat ini menyediakan tempat duduk khusus pengguna kursi roda.

AddressComponent

Komponen terstruktur yang membentuk alamat berformat, jika informasi ini tersedia.

Kolom
long_text

string

Deskripsi teks lengkap atau nama komponen alamat. Misalnya, komponen alamat untuk negara Australia mungkin memiliki long_name "Australia".

short_text

string

Nama tekstual yang disingkat untuk komponen alamat, jika tersedia. Misalnya, komponen alamat untuk negara Australia dapat memiliki short_name "AU".

types[]

string

Array yang menunjukkan jenis komponen alamat.

language_code

string

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[]

ContentBlock

Blok konten yang menyusun ringkasan area. Setiap blok memiliki topik terpisah tentang area tersebut.

flag_content_uri

string

Link tempat pengguna dapat melaporkan masalah terkait ringkasan.

Atribusi

Informasi tentang penyedia data tempat ini.

Kolom
provider

string

Nama penyedia data Tempat.

provider_uri

string

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

string

Nama resource tempat tempat ini berada.

id

string

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

LocalizedText

Ringkasan tempat.

overview_flag_content_uri

string

Link tempat pengguna dapat melaporkan masalah terkait ringkasan ringkasan.

description

LocalizedText

Deskripsi mendetail tentang tempat.

description_flag_content_uri

string

Link tempat pengguna dapat melaporkan masalah dengan ringkasan deskripsi.

references

References

Referensi yang digunakan untuk membuat deskripsi ringkasan.

OpeningHours

Informasi tentang jam buka tempat.

Kolom
periods[]

Period

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

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

SecondaryHoursType

String jenis yang digunakan untuk mengidentifikasi jenis jam sekunder.

special_days[]

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. Tetapkan untuk current_opening_hours dan current_secondary_opening_hours jika ada jam buka khusus.

next_open_time

Timestamp

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

Timestamp

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

bool

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.

Kolom
open

Point

Waktu tempat mulai buka.

close

Point

Waktu tempat mulai ditutup.

Titik

Titik perubahan status.

Kolom
date

Date

Tanggal dalam zona waktu lokal untuk tempat tersebut.

truncated

bool

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

int32

Hari dalam seminggu, sebagai bilangan bulat dalam rentang 0-6. 0 adalah Minggu, 1 adalah Senin, dst.

hour

int32

Jam dalam format 24 jam. Rentang dari 0 hingga 23.

minute

int32

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

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

bool

Tempat ini menawarkan tempat parkir gratis.

paid_parking_lot

bool

Tempat ini menawarkan tempat parkir berbayar.

free_street_parking

bool

Tempat ini menawarkan parkir di jalan gratis.

paid_street_parking

bool

Tempat ini menawarkan tempat parkir di pinggir jalan berbayar.

valet_parking

bool

Tempat ini menawarkan parkir valet.

free_garage_parking

bool

Tempat ini menawarkan parkir garasi gratis.

paid_garage_parking

bool

Tempat ini menawarkan parkir garasi berbayar.

PaymentOptions

Opsi pembayaran yang diterima tempat tersebut.

Kolom
accepts_credit_cards

bool

Tempat menerima kartu kredit sebagai pembayaran.

accepts_debit_cards

bool

Tempat menerima kartu debit sebagai pembayaran.

accepts_cash_only

bool

Tempat ini hanya menerima pembayaran tunai. Tempat dengan atribut ini mungkin masih menerima metode pembayaran lainnya.

accepts_nfc

bool

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

string

Kode global (lengkap) tempat, seperti "9FWM33GV+HQ", yang mewakili area 1/8000 derajat x 1/8000 derajat (~14 x 14 meter).

compound_code

string

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

string

Nama resource sub-tujuan.

id

string

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

string

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").

Kolom
start_price

Money

Ujung bawah rentang harga (inklusif). Harga harus sama dengan atau lebih tinggi dari jumlah ini.

end_price

Money

Ujung atas rentang harga (eksklusif). Harga harus lebih rendah dari jumlah ini.

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[]

Review

Ulasan yang berfungsi sebagai referensi.

places[]

string

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

string

Referensi yang mewakili ulasan tempat ini yang dapat digunakan untuk mencari ulasan tempat ini lagi (juga disebut nama "resource" API: places/{place_id}/reviews/{review}).

relative_publish_time_description

string

String waktu terbaru yang diformat, yang menyatakan waktu peninjauan relatif terhadap waktu saat ini dalam bentuk yang sesuai untuk bahasa dan negara.

text

LocalizedText

Teks ulasan yang dilokalkan.

original_text

LocalizedText

Teks ulasan dalam bahasa aslinya.

rating

double

Angka antara 1,0 dan 5,0, yang juga disebut jumlah bintang.

author_attribution

AuthorAttribution

Penulis ulasan ini.

publish_time

Timestamp

Stempel waktu untuk ulasan.

flag_content_uri

string

Link tempat pengguna dapat melaporkan masalah terkait ulasan.

google_maps_uri

string

Link untuk menampilkan ulasan di Google Maps.

RouteModifiers

Mengenkapsulasi serangkaian kondisi opsional yang harus dipenuhi saat menghitung rute.

Kolom
avoid_tolls

bool

Opsional. Jika disetel ke benar, menghindari jalan tol jika memungkinkan, dengan memberikan preferensi ke rute yang tidak berisi jalan tol. Hanya berlaku untuk DRIVE dan TWO_WHEELER TravelMode.

avoid_highways

bool

Opsional. Jika disetel ke benar (true), menghindari jalan raya jika memungkinkan, dengan memberikan preferensi ke rute yang tidak berisi jalan raya. Hanya berlaku untuk DRIVE dan TWO_WHEELER TravelMode.

avoid_ferries

bool

Opsional. Jika disetel ke benar, menghindari feri jika memungkinkan, memberikan preferensi ke rute yang tidak berisi feri. Hanya berlaku untuk DRIVE dan TWO_WHEELER TravelMode.

avoid_indoor

bool

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 WALK TravelMode.

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

LatLng

Opsional. Asal pemilihan rute eksplisit yang mengganti asal yang ditentukan dalam polyline. Secara default, asal polyline digunakan.

travel_mode

TravelMode

Opsional. Mode perjalanan.

route_modifiers

RouteModifiers

Opsional. Pengubah rute.

routing_preference

RoutingPreference

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 DRIVE atau TWO_WHEELER travelMode.

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 TravelMode 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[]

Leg

Segmen perjalanan.

Saat Anda menghitung durasi dan jarak perjalanan dari asal yang ditetapkan, legs berisi satu segmen yang berisi durasi dan jarak dari asal ke tujuan. Saat Anda melakukan penelusuran di sepanjang rute, legs berisi dua segmen: satu dari asal ke tempat, dan satu dari tempat ke tujuan.

directions_uri

string

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 routingParameters dan searchAlongRouteParameters jika berlaku, untuk membuat link rute.

Kaki

Segmen adalah satu bagian perjalanan dari satu lokasi ke lokasi lainnya.

Kolom
duration

Duration

Waktu yang diperlukan untuk menyelesaikan bagian perjalanan ini.

distance_meters

int32

Jarak segmen perjalanan ini.

SearchNearbyRequest

Meminta proto untuk Penelusuran di Sekitar.

Kolom
language_code

string

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

string

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[]

string

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[]

string

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[]

string

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[]

string

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

int32

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

LocationRestriction

Wajib. Wilayah yang akan ditelusuri.

rank_preference

RankPreference

Cara hasil akan diberi peringkat dalam respons.

routing_parameters

RoutingParameters

Opsional. Parameter yang memengaruhi pemilihan rute ke hasil penelusuran.

LocationRestriction

Wilayah yang akan ditelusuri.

Kolom

Kolom union type.

type hanya dapat berupa salah satu dari hal berikut:

circle

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[]

Place

Daftar tempat yang memenuhi persyaratan pengguna seperti jenis tempat, jumlah tempat, dan batasan lokasi tertentu.

routing_summaries[]

RoutingSummary

Daftar ringkasan pemilihan rute dengan setiap entri dikaitkan ke tempat yang sesuai dalam indeks yang sama di kolom places. Jika ringkasan pemilihan rute tidak tersedia untuk salah satu tempat, ringkasan tersebut akan berisi entri kosong. Daftar ini harus memiliki entri sebanyak daftar tempat jika diminta.

SearchTextRequest

Meminta proto untuk SearchText.

Kolom
text_query

string

Wajib. Kueri teks untuk penelusuran tekstual.

language_code

string

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

string

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

RankPreference

Cara hasil akan diberi peringkat dalam respons.

included_type

string

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

bool

Digunakan untuk membatasi penelusuran ke tempat yang saat ini buka. Default-nya adalah salah.

min_rating

double

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
(deprecated)

int32

Tidak digunakan lagi: Gunakan page_size sebagai gantinya.

Jumlah maksimum hasil per halaman yang dapat ditampilkan. Jika jumlah hasil yang tersedia lebih besar dari max_result_count, next_page_token akan ditampilkan yang dapat diteruskan ke page_token untuk mendapatkan halaman hasil berikutnya dalam permintaan berikutnya. Jika 0 atau tidak ada nilai yang diberikan, nilai default 20 akan digunakan. Nilai maksimum adalah 20; nilai di atas 20 akan dikonversi menjadi 20. Nilai negatif akan menampilkan error INVALID_ARGUMENT.

Jika max_result_count dan page_size ditentukan, max_result_count akan diabaikan.

page_size

int32

Opsional. Jumlah maksimum hasil per halaman yang dapat ditampilkan. Jika jumlah hasil yang tersedia lebih besar dari page_size, next_page_token akan ditampilkan yang dapat diteruskan ke page_token untuk mendapatkan halaman hasil berikutnya dalam permintaan berikutnya. Jika 0 atau tidak ada nilai yang diberikan, nilai default 20 akan digunakan. Nilai maksimum adalah 20; nilai di atas 20 akan ditetapkan ke 20. Nilai negatif akan menampilkan error INVALID_ARGUMENT.

Jika max_result_count dan page_size ditentukan, max_result_count akan diabaikan.

page_token

string

Opsional. Token halaman, diterima dari panggilan TextSearch sebelumnya. Berikan ini untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter selain page_token, page_size, dan max_result_count yang diberikan ke TextSearch harus cocok dengan panggilan awal yang menyediakan token halaman. Jika tidak, error INVALID_ARGUMENT akan ditampilkan.

price_levels[]

PriceLevel

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

bool

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

LocationBias

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

LocationRestriction

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

EVOptions

Opsional. Menetapkan opsi EV yang dapat ditelusuri dari permintaan penelusuran tempat.

routing_parameters

RoutingParameters

Opsional. Parameter tambahan untuk pemilihan rute ke hasil.

search_along_route_parameters

SearchAlongRouteParameters

Opsional. Proto parameter tambahan untuk menelusuri di sepanjang rute.

include_pure_service_area_businesses

bool

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 location, plus_code, dan kolom terkait lokasi lainnya untuk bisnis ini.

EVOptions

Opsi Kendaraan Listrik Umum yang dapat ditelusuri dari permintaan penelusuran tempat.

Kolom
minimum_charging_rate_kw

double

Opsional. Kecepatan pengisian daya minimum yang diperlukan dalam kilowatt. Tempat dengan tarif pengisian daya kurang dari tarif yang ditentukan akan difilter.

connector_types[]

EVConnectorType

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 type.

type hanya dapat berupa salah satu dari hal berikut:

rectangle

Viewport

Kotak persegi panjang yang ditentukan oleh sudut timur laut dan barat daya. rectangle.high() harus berupa titik timur laut dari area pandang persegi panjang. rectangle.low() harus berupa titik barat daya area pandang persegi panjang. rectangle.low().latitude() tidak boleh lebih besar dari rectangle.high().latitude(). Tindakan ini akan menghasilkan rentang lintang kosong. Area pandang persegi panjang tidak boleh lebih lebar dari 180 derajat.

circle

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 type.

type hanya dapat berupa salah satu dari hal berikut:

rectangle

Viewport

Kotak persegi panjang yang ditentukan oleh sudut timur laut dan barat daya. rectangle.high() harus berupa titik timur laut dari area pandang persegi panjang. rectangle.low() harus berupa titik barat daya area pandang persegi panjang. rectangle.low().latitude() tidak boleh lebih besar dari rectangle.high().latitude(). Tindakan ini akan menghasilkan rentang lintang kosong. Area pandang persegi panjang tidak boleh lebih lebar dari 180 derajat.

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

Polyline

Wajib. Polyline rute.

SearchTextResponse

Proto respons untuk SearchText.

Kolom
places[]

Place

Daftar tempat yang memenuhi kriteria penelusuran teks pengguna.

routing_summaries[]

RoutingSummary

Daftar ringkasan pemilihan rute dengan setiap entri dikaitkan ke tempat yang sesuai dalam indeks yang sama di kolom places. Jika ringkasan pemilihan rute tidak tersedia untuk salah satu tempat, ringkasan tersebut akan berisi entri kosong. Daftar ini akan memiliki entri sebanyak daftar tempat jika diminta.

contextual_contents[]

ContextualContent

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 text_query dalam permintaan lebih disukai. Jika konten kontekstual tidak tersedia untuk salah satu tempat, konten non-kontekstual akan ditampilkan. Kolom ini hanya akan kosong jika konten tidak tersedia untuk tempat ini. Daftar ini akan memiliki entri sebanyak daftar tempat jika diminta.

next_page_token

string

Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan atau kosong, maka tidak ada halaman berikutnya.

search_uri

string

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.