Package google.maps.places.v1

Indeks

Tempat

Definisi layanan untuk Places API. Catatan: setiap permintaan (kecuali permintaan Autocomplete dan GetPhotoMedia) memerlukan set mask kolom di luar proto permintaan (all/*, tidak diasumsikan). Mask kolom dapat disetel 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 berdasarkan kueri teks.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

AddressDescriptor

Deskripsi relasional lokasi. Mencakup serangkaian bangunan terkenal terdekat yang diberi peringkat dan area yang tepat yang berisi lokasi target serta hubungannya dengan lokasi target.

Kolom
landmarks[]

Landmark

Daftar tempat terkenal di sekitar yang diurutkan berdasarkan peringkat. Bangunan terdekat dan paling dikenal diberi peringkat pertama.
areas[]

Area

Daftar berperingkat area yang berisi atau berdekatan. Area yang paling mudah dikenali dan paling presisi diberi peringkat pertama.

Area

Informasi area dan hubungan area dengan lokasi target.

Area mencakup sublokalitas yang tepat, lingkungan, dan kompleks besar 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 Penampungan tidak ditentukan.
WITHIN Lokasi target berada dalam wilayah area, dekat dengan bagian tengah.
OUTSKIRTS Lokasi target berada dalam wilayah area, dekat dengan tepi.
NEAR Lokasi target berada di luar area wilayah, tetapi dekat.

Tempat terkenal

Informasi dasar tentang tempat terkenal dan hubungan tempat terkenal tersebut dengan lokasi target.

Landmark adalah tempat terkenal yang dapat digunakan untuk mendeskripsikan lokasi.

Kolom
name

string

Nama resource landmark.
place_id

string

ID tempat landmark.
display_name

LocalizedText

Nama tampilan tempat penting.
types[]

string

Kumpulan tag jenis untuk tempat terkenal ini. Untuk mengetahui daftar lengkap kemungkinan nilai, lihat https://developers.google.com/maps/documentation/places/web-service/place-types.
spatial_relationship

SpatialRelationship

Menentukan hubungan spasial antara target lokasi dan landmark.
straight_line_distance_meters

float

Jarak garis lurus, dalam meter, antara titik tengah target dan titik tengah landmark. Dalam beberapa situasi, nilai ini bisa lebih panjang dari travel_distance_meters.
travel_distance_meters

float

Jarak perjalanan, dalam meter, di sepanjang jaringan jalan dari target ke tempat penting, jika diketahui. Nilai ini tidak memperhitungkan moda transportasi, seperti berjalan kaki, mengemudi, atau bersepeda.

SpatialRelationship

Menentukan hubungan spasial antara target lokasi dan landmark.

Enum
NEAR Ini adalah hubungan default jika tidak ada yang lebih spesifik di bawah yang berlaku.
WITHIN Landmark memiliki geometri spasial dan target berada dalam batasnya.
BESIDE Target berdekatan langsung dengan landmark.
ACROSS_THE_ROAD Target berada tepat di seberang bangunan di sisi lain jalan.
DOWN_THE_ROAD Di rute yang sama dengan lokasi penting, tetapi tidak di samping atau di seberang.
AROUND_THE_CORNER Tidak berada di rute yang sama dengan lokasi, tetapi hanya berjarak satu belokan.
BEHIND Dekat dengan struktur landmark, tetapi lebih jauh dari pintu masuknya di jalan.

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

Proto permintaan 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 yang harus ditetapkan. Jika keduanya tidak ditetapkan, hasilnya akan dipengaruhi oleh 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 tertentu.

Maksimal satu dari location_bias atau location_restriction yang harus ditetapkan. Jika keduanya tidak ditetapkan, hasilnya akan dipengaruhi oleh alamat IP, yang berarti alamat IP akan dipetakan ke lokasi yang tidak akurat dan digunakan sebagai sinyal bias.
included_primary_types[]

string

Opsional. Jenis Tempat utama yang disertakan (misalnya, "restaurant" atau "gas_station") dalam 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 menyertakan hasil di wilayah yang ditentukan, yang ditentukan sebagai hingga 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. Nilai 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 pemformatan alamat, peringkat hasil, dan dapat memengaruhi hasil yang ditampilkan. Hal ini tidak membatasi hasil ke wilayah yang ditentukan. Untuk membatasi hasil ke suatu region, gunakan region_code_restriction.
origin

LatLng

Opsional. Titik asal untuk menghitung jarak geodetik ke tujuan (ditampilkan sebagai distance_meters). Jika nilai ini tidak ada, jarak geodetik 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, defaultnya adalah panjang input.
include_query_predictions

bool

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

string

Opsional. String yang mengidentifikasi sesi Pelengkapan Otomatis untuk tujuan penagihan. Harus berupa string base64 yang aman untuk URL dan nama file dengan panjang maksimal 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 termasuk dalam 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 (true). 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 tampilan 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 ke wilayah yang ditentukan.

Kolom

Kolom union type.

type hanya dapat berupa salah satu dari hal berikut:
rectangle

Viewport

Area tampilan 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 dari atas ke bawah.

Saran

Hasil saran pelengkapan otomatis.

Kolom

Kolom union kind.

kind hanya dapat berupa salah satu dari hal berikut:
place_prediction

PlacePrediction

Prediksi untuk suatu Tempat.
query_prediction

QueryPrediction

Prediksi untuk kueri.

FormattableText

Teks yang merepresentasikan prediksi Tempat atau 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 cocok dalam text. Rentang dapat digunakan untuk memformat bagian tertentu dari text. Substring mungkin bukan pencocokan persis dari input jika pencocokan ditentukan oleh kriteria selain pencocokan string (misalnya, koreksi ejaan atau transliterasi).

Nilai ini adalah offset karakter Unicode dari text. Rentang dijamin 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 mudah dibaca untuk hasil yang ditampilkan. Untuk hasil tempat, biasanya ini adalah nama dan alamat bisnis.

text direkomendasikan untuk developer yang ingin menampilkan satu elemen UI. Developer yang ingin menampilkan dua elemen UI yang terpisah, tetapi terkait, mungkin ingin menggunakan structured_format sebagai gantinya. 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 ke dalam teks utama yang berisi nama Tempat dan teks sekunder yang berisi fitur tambahan yang memperjelas (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 dapat menggunakan text sebagai gantinya. 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 Pelengkapan Otomatis Kueri.

Kolom
text

FormattableText

Teks yang diprediksi. Teks ini tidak merepresentasikan Tempat, melainkan 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 yang terpisah, tetapi terkait, mungkin ingin menggunakan structured_format sebagai gantinya. 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 sebagian 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 tambahan untuk memperjelas (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 dapat menggunakan text sebagai gantinya. 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 perincian 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 tambahan yang memperjelas (seperti kota atau wilayah) untuk mengidentifikasi Tempat lebih lanjut atau menyaring kueri.

Kolom
main_text

FormattableText

Mewakili nama Tempat atau kueri.
secondary_text

FormattableText

Mewakili fitur tambahan yang memperjelas (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 garis 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 secara terpisah.

Kolom
content

LocalizedText

Konten yang terkait dengan topik.
referenced_places[]

string

Daftar nama resource tempat yang dirujuk. Nama ini dapat digunakan di API lain yang menerima nama resource Place.

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 sesuai dengan kueri tempat.
photos[]

Photo

Informasi (termasuk referensi) tentang foto tempat ini, yang sesuai 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 tersebut.

Pembenaran

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

Justifikasi untuk tempat tersebut. 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. Bagian ini menampilkan beberapa atribut yang dimiliki bisnis yang dapat menarik minat pengguna akhir.

Kolom
takeout

bool

Jika tempat menyediakan layanan bawa pulang.
delivery

bool

Jika tempat menyediakan layanan pesan antar.
dine_in

bool

Jika tempat 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. Bagian ini menyoroti bagian ulasan pengguna yang akan menarik minat pengguna akhir. Misalnya, jika kueri penelusuran adalah "pizza kayu bakar", pembenaran ulasan akan menandai teks yang relevan dengan kueri penelusuran.

Kolom
highlighted_text

HighlightedText
review

Review

Ulasan yang menjadi asal teks yang ditandai.

HighlightedText

Teks yang ditandai oleh justifikasi. Ini adalah subset 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 Place. 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 SPKLU memiliki satu atau beberapa port.

Kolom
connector_count

int32

Jumlah konektor di SPKLU 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 daripada jumlah total mobil yang dapat mengisi daya secara bersamaan.
connector_aggregation[]

ConnectorAggregation

Daftar penggabungan konektor pengisian daya kendaraan listrik yang berisi konektor dengan jenis yang sama dan kecepatan pengisian daya yang sama.

ConnectorAggregation

Informasi pengisian daya kendaraan listrik dikelompokkan menurut [type, max_charge_rate_kw]. Menampilkan penggabungan pengisian daya EV untuk konektor yang memiliki jenis dan kecepatan pengisian daya maks. 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 penggabungan.
count

int32

Jumlah konektor dalam penggabungan 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 penggabungan ini yang saat ini tidak berfungsi.

EVConnectorType

Lihat http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 untuk mengetahui informasi/konteks tambahan tentang jenis konektor pengisi daya EV.

Enum
EV_CONNECTOR_TYPE_UNSPECIFIED Konektor tidak ditentukan.
EV_CONNECTOR_TYPE_OTHER Jenis konektor lainnya.
EV_CONNECTOR_TYPE_J1772 Konektor tipe 1 J1772.
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 Type-2
EV_CONNECTOR_TYPE_TESLA Konektor TESLA generik. Ini adalah NACS di Amerika Utara, tetapi dapat berupa non-NACS di belahan dunia lainnya (misalnya, CCS Combo 2 (CCS2) atau GB/T). Nilai ini kurang merepresentasikan jenis konektor sebenarnya, dan lebih merepresentasikan 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 distandardisasi 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 dimiliki 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 Bahan bakar diesel plus.
REGULAR_UNLEADED Bensin tanpa timbal reguler.
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 suatu 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 yang ditampilkan di kolom photos.name objek Place memiliki format places/{place_id}/photos/{photo_reference}. Anda perlu 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 dalam salah satu dimensi, gambar akan diskalakan agar sesuai dengan dimensi yang lebih kecil, dengan 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 maupun 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 dalam salah satu dimensi, gambar akan diskalakan agar sesuai dengan dimensi yang lebih kecil, dengan 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 maupun max_width_px tidak ditentukan, error INVALID_ARGUMENT akan ditampilkan.
skip_http_redirect

bool

Opsional. Jika disetel, lewati perilaku pengalihan HTTP default dan render respons format teks (misalnya, dalam format JSON untuk kasus penggunaan HTTP). Jika tidak disetel, pengalihan HTTP akan dilakukan 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 dalam 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 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 Pelengkapan Otomatis untuk tujuan penagihan. Harus berupa string base64 yang aman untuk URL dan nama file dengan panjang maksimal 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 termasuk dalam 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 merepresentasikan 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 sementara yang dapat digunakan untuk merender foto.

Tempat

Semua informasi yang merepresentasikan suatu 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 kemungkinan nilai, 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 salah satu jenis yang didukung Places API. Misalnya, "restoran", "kafe", "bandara", dll. Suatu tempat hanya dapat memiliki satu jenis utama. Untuk daftar lengkap kemungkinan nilai, lihat Tabel A dan Tabel B di https://developers.google.com/maps/documentation/places/web-service/place-types. Jenis utama mungkin tidak ada jika jenis utama tempat bukan jenis yang didukung. Jika ada jenis utama, jenis tersebut selalu merupakan salah satu jenis di kolom types.
primary_type_display_name

LocalizedText

Nama tampilan jenis utama, dilokalkan ke bahasa permintaan jika berlaku. Untuk daftar lengkap kemungkinan nilai, lihat Tabel A dan Tabel B di https://developers.google.com/maps/documentation/places/web-service/place-types. Jenis utama mungkin tidak ada jika jenis utama tempat bukan jenis yang didukung.
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 mudah dibaca untuk tempat ini.
postal_address

PostalAddress

Alamat dalam format alamat pos.
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 garis 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 di peta berukuran rata-rata. Area tampilan 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), biasanya ini adalah situs untuk setiap toko, bukan jaringan secara keseluruhan.
reviews[]

Review

Daftar ulasan tentang tempat ini, diurutkan berdasarkan 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 kondisi selalu buka (24 jam) yang direpresentasikan sebagai periode open yang berisi day dengan nilai 0, hour dengan nilai 0, dan minute dengan nilai 0.
time_zone

TimeZone

Zona waktu IANA Time Zone Database. 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 format mikro 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 dipangkas ke masker ikon. Pengguna dapat mengakses berbagai jenis ikon dengan menambahkan sufiks jenis di akhir (misalnya, ".svg" atau ".png").
icon_background_color

string

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

OpeningHours

Jam operasional 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 sub-kolom special_days dari semua jam, yang ditetapkan untuk tanggal yang memiliki jam khusus.
current_secondary_opening_hours[]

OpeningHours

Berisi array entri untuk tujuh hari berikutnya, termasuk informasi tentang jam buka sekunder bisnis. Jam sekunder berbeda dengan jam buka utama bisnis. Misalnya, restoran dapat menentukan jam layanan drive-thru atau jam pengiriman 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 sub-kolom 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 sekunder berbeda dengan jam buka utama bisnis. Misalnya, restoran dapat menentukan jam layanan drive-thru atau jam pengiriman 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 tekstual, 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 ini. Jika data opsi pembayaran tidak tersedia, kolom opsi pembayaran tidak akan ditetapkan.
parking_options

ParkingOptions

Opsi tempat 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 opsi pengisian daya kendaraan listrik.
generative_summary

GenerativeSummary

Ringkasan tempat yang dibuat AI.
containing_places[]

ContainingPlace

Daftar tempat di mana tempat saat ini berada.
address_descriptor

AddressDescriptor

Deskripsi alamat tempat. Deskripsi alamat mencakup informasi tambahan yang membantu mendeskripsikan lokasi menggunakan tempat terkenal dan area. Lihat cakupan regional deskriptor alamat di https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.
price_range

PriceRange

Rentang harga yang terkait dengan Tempat.
review_summary

ReviewSummary

Ringkasan tempat yang dibuat AI menggunakan ulasan pengguna.
ev_charge_amenity_summary

EvChargeAmenitySummary

Ringkasan fasilitas di dekat SPKLU.
neighborhood_summary

NeighborhoodSummary

Ringkasan tempat menarik di dekat lokasi.
consumer_alert

ConsumerAlert

Pesan peringatan konsumen untuk tempat tersebut jika kami mendeteksi aktivitas ulasan yang mencurigakan di suatu bisnis atau bisnis melanggar kebijakan kami.
utc_offset_minutes

int32

Jumlah menit selisih zona waktu tempat ini dari UTC saat ini. Hal ini dinyatakan dalam menit untuk mendukung zona waktu yang memiliki selisih waktu dalam 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 layanan pesan bawa.
delivery

bool

Menentukan apakah bisnis mendukung pengiriman.
dine_in

bool

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

bool

Menentukan apakah bisnis mendukung pengambilan di tepi jalan.
reservable

bool

Menentukan apakah tempat mendukung reservasi.
serves_breakfast

bool

Menentukan apakah tempat ini menyajikan sarapan.
serves_lunch

bool

Menentukan apakah tempat ini menyajikan makan siang.
serves_dinner

bool

Menentukan apakah tempat menyajikan makan malam.
serves_beer

bool

Menentukan apakah tempat ini menyajikan bir.
serves_wine

bool

Menentukan apakah tempat menyajikan wine.
serves_brunch

bool

Menentukan apakah tempat menyajikan brunch.
serves_vegetarian_food

bool

Menentukan apakah tempat ini menyajikan makanan vegetarian.
outdoor_seating

bool

Tempat ini menyediakan tempat duduk di luar ruangan.
live_music

bool

Tempat ini menyajikan musik live.
menu_for_children

bool

Tempat ini memiliki menu anak-anak.
serves_cocktails

bool

Tempat ini menyajikan koktail.
serves_dessert

bool

Tempat menyajikan hidangan penutup.
serves_coffee

bool

Tempat ini menyajikan kopi.
good_for_children

bool

Tempat ini cocok untuk anak-anak.
allows_dogs

bool

Tempat mengizinkan.
restroom

bool

Tempat memiliki toilet.
good_for_groups

bool

Tempat ini dapat menampung grup.
good_for_watching_sports

bool

Tempat ini 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 adalah 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 tempat parkir khusus pengguna kursi roda.
wheelchair_accessible_entrance

bool

Tempat ini 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 yang diformat, jika informasi ini tersedia.

Kolom
long_text

string

Deskripsi teks lengkap atau nama komponen alamat. Misalnya, komponen alamat untuk negara Australia dapat 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.

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.

ConsumerAlert

Pesan peringatan konsumen untuk tempat tersebut jika kami mendeteksi aktivitas ulasan yang mencurigakan di suatu bisnis atau bisnis melanggar kebijakan kami.

Kolom
overview

string

Ringkasan pesan pemberitahuan konsumen.
details

Details

Detail pesan pemberitahuan konsumen.ƒ
language_code

string

Kode bahasa pesan peringatan konsumen. Ini adalah kode bahasa BCP 47.

Detail

Detail pesan peringatan konsumen.

Kolom
title

string

Judul yang akan ditampilkan bersama deskripsi.
description

string

Deskripsi pesan pemberitahuan konsumen.

ContainingPlace

Info tentang tempat di mana tempat ini berada.

Kolom
name

string

Nama resource tempat lokasi ini berada.
id

string

ID tempat dari tempat di mana tempat ini berada.

EvChargeAmenitySummary

Ringkasan fasilitas di dekat SPKLU. Ini hanya berlaku untuk tempat dengan jenis electric_vehicle_charging_station. Kolom overview dijamin akan diberikan, sedangkan kolom lainnya bersifat opsional.

Kolom
overview

ContentBlock

Ringkasan fasilitas yang tersedia. Hal ini dijamin akan diberikan.
coffee

ContentBlock

Ringkasan opsi kopi di sekitar.
restaurant

ContentBlock

Ringkasan restoran di sekitar.
store

ContentBlock

Ringkasan toko terdekat.
flag_content_uri

string

Link tempat pengguna dapat melaporkan masalah terkait ringkasan.
disclosure_text

LocalizedText

Pesan pengungkapan AI "Diringkas dengan Gemini" (dan varian yang dilokalkan). Respons akan dalam bahasa yang ditentukan dalam permintaan jika tersedia.

GenerativeSummary

Ringkasan tempat yang dibuat AI.

Kolom
overview

LocalizedText

Ringkasan tempat.
overview_flag_content_uri

string

Link tempat pengguna dapat melaporkan masalah terkait ringkasan ikhtisar.
disclosure_text

LocalizedText

Pesan pengungkapan AI "Diringkas dengan Gemini" (dan varian yang dilokalkan). Respons akan dalam bahasa yang ditentukan dalam permintaan jika tersedia.

NeighborhoodSummary

Ringkasan tempat menarik di dekat lokasi.

Kolom
overview

ContentBlock

Ringkasan umum lingkungan sekitar.
description

ContentBlock

Deskripsi mendetail tentang lingkungan sekitar.
flag_content_uri

string

Link tempat pengguna dapat melaporkan masalah terkait ringkasan.
disclosure_text

LocalizedText

Pesan pengungkapan AI "Diringkas dengan Gemini" (dan varian yang dilokalkan). Respons akan dalam bahasa yang ditentukan dalam permintaan jika tersedia.

OpeningHours

Informasi tentang jam buka tempat.

Kolom
periods[]

Period

Jangka waktu buka tempat ini selama seminggu. Periode diurutkan secara kronologis, dalam zona waktu lokal tempat. Nilai kosong (tetapi tidak ada) menunjukkan tempat yang tidak pernah buka, misalnya karena ditutup sementara untuk renovasi.

Hari mulai periods TIDAK tetap dan tidak boleh diasumsikan sebagai hari Minggu. API menentukan hari mulai berdasarkan berbagai faktor. Misalnya, untuk bisnis yang beroperasi 24/7, periode pertama dapat dimulai pada hari permintaan. Untuk bisnis lain, mungkin hari pertama dalam seminggu saat mereka buka.

CATATAN: Urutan array periods tidak bergantung pada urutan array weekday_descriptions. Jangan menganggap bahwa keduanya akan dimulai pada hari yang sama.
weekday_descriptions[]

string

String yang dilokalkan yang menjelaskan jam buka tempat ini, satu string untuk setiap hari dalam seminggu.

CATATAN: Urutan hari dan awal pekan ditentukan oleh lokalitas (bahasa dan wilayah). Urutan array periods tidak bergantung pada urutan array weekday_descriptions. Jangan menganggap bahwa keduanya akan dimulai pada hari yang sama.

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 buka 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 berakhir periode jam buka saat ini paling lambat 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 berarti apakah tempat tersebut buka. Untuk jam buka sekunder dan jam buka sekunder saat ini, kolom ini berarti apakah jam sekunder tempat ini aktif.

Periode

Periode tempat tetap dalam status open_now.

Kolom
open

Point

Waktu mulai tempat buka.
close

Point

Waktu tempat mulai ditutup.

Titik

Poin perubahan status.

Kolom
date

Date

Tanggal dalam zona waktu lokal untuk tempat tersebut.
truncated

bool

Apakah endpoint ini dipangkas atau tidak. Pemangkasan terjadi saat jam sebenarnya berada di luar rentang waktu yang ingin kita kembalikan, sehingga kita memangkas jam kembali ke batas ini. Hal ini memastikan bahwa paling banyak 24 * 7 jam sejak tengah malam pada hari permintaan dikembalikan.
day

int32

Hari dalam seminggu, sebagai bilangan bulat dalam rentang 0-6. 0 adalah Minggu, 1 adalah Senin, dll.
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 buka sekunder.

Enum
SECONDARY_HOURS_TYPE_UNSPECIFIED Nilai default jika jenis jam sekunder tidak ditentukan.
DRIVE_THROUGH Jam layanan drive-through untuk bank, restoran, atau apotek.
HAPPY_HOUR Happy hour.
DELIVERY Jam pengiriman.
TAKEOUT Waktu pengambilan.
KITCHEN Jam buka dapur.
BREAKFAST Waktu sarapan.
LUNCH Waktu makan siang.
DINNER Waktu makan malam.
BRUNCH Waktu brunch.
PICKUP Waktu 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 istimewa 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 di garasi gratis.
paid_garage_parking

bool

Tempat ini menawarkan tempat parkir di garasi berbayar.

PaymentOptions

Opsi pembayaran yang diterima tempat ini.

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 hanya menerima pembayaran tunai. Tempat dengan atribut ini mungkin masih menerima metode pembayaran lain.
accepts_nfc

bool

Tempat menerima pembayaran NFC.

PlusCode

Plus Codes (http://plus.codes) adalah referensi lokasi dengan dua format: kode global yang menentukan persegi panjang 14 m x 14 m (1/8000 derajat) atau lebih kecil, dan kode gabungan, yang menggantikan awalan dengan lokasi referensi.

Kolom
global_code

string

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

string

Kode gabungan tempat, seperti "33GV+HQ, Ramberg, Norwegia", yang berisi sufiks kode global dan mengganti awalan dengan nama entitas referensi yang diformat.

ReviewSummary

Ringkasan tempat yang dibuat AI menggunakan ulasan pengguna.

Kolom
text

LocalizedText

Ringkasan ulasan pengguna.
flag_content_uri

string

Link tempat pengguna dapat melaporkan masalah terkait ringkasan.
disclosure_text

LocalizedText

Pesan pengungkapan AI "Diringkas dengan Gemini" (dan varian yang dilokalkan). Respons akan dalam bahasa yang ditentukan dalam permintaan jika tersedia.
reviews_uri

string

Link untuk menampilkan ulasan tempat ini di Google Maps.

SubDestination

Sub-tujuan adalah tempat tertentu yang terkait dengan tempat utama. Tujuan ini memberikan tujuan yang lebih spesifik bagi pengguna yang menelusuri dalam tempat yang 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 (Baru) berikutnya untuk mengambil detail yang lebih lengkap, termasuk nama tampilan 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 mencakup kompresi dengan kehilangan minimal. Ini adalah output default Routes API.

Kolom
Kolom union polyline_type. Mencakup 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 menyediakan layanan yang tidak mahal.
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, yang menunjukkan rentang tanpa batas atas (misalnya, "Lebih dari Rp1.000.000").

Kolom
start_price

Money

Ujung rendah rentang harga (inklusif). Harga harus sama dengan atau di atas jumlah ini.
end_price

Money

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

Tinjau

Informasi tentang ulasan tempat.

Kolom
name

string

Referensi yang merepresentasikan 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 ulasan 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, 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.
visit_date

Date

Tanggal saat penulis mengunjungi tempat tersebut. Ini dipangkas menjadi bulan.

RouteModifiers

Mencakup serangkaian kondisi opsional yang harus dipenuhi saat menghitung rute.

Kolom
avoid_tolls

bool

Opsional. Jika disetel ke benar (true), hindari jalan tol jika memungkinkan, dengan memprioritaskan rute yang tidak berisi jalan tol. Hanya berlaku untuk DRIVE dan TWO_WHEELER TravelMode.
avoid_highways

bool

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

bool

Opsional. Jika disetel ke benar (true), akan menghindari feri jika memungkinkan, dengan memprioritaskan rute yang tidak berisi feri. Hanya berlaku untuk DRIVE dan TWO_WHEELER TravelMode.
avoid_indoor

bool

Opsional. Jika disetel ke benar (true), hindari navigasi di dalam ruangan jika memungkinkan, dengan memprioritaskan rute yang tidak berisi navigasi dalam ruangan. Hanya berlaku untuk WALK TravelMode.

RoutingParameters

Parameter untuk mengonfigurasi penghitungan perutean ke tempat-tempat dalam respons, baik di sepanjang rute (tempat peringkat hasil akan dipengaruhi) maupun untuk menghitung waktu perjalanan pada hasil.

Kolom
origin

LatLng

Opsional. Asal perutean eksplisit yang menggantikan 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 perutean. Server mencoba menggunakan preferensi perutean 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. Menggunakan nilai ini akan menghasilkan latensi terendah. Catatan: Untuk TravelMode DRIVE dan TWO_WHEELER, rute dan durasi yang dipilih didasarkan pada jaringan jalan dan kondisi lalu lintas tanpa memperhitungkan waktu rata-rata, 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 langsung. 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. Menggunakan nilai ini akan menghasilkan latensi tertinggi.

RoutingSummary

Durasi dan jarak dari asal perutean ke suatu tempat dalam respons, dan segmen kedua dari tempat tersebut ke tujuan, jika diminta. Catatan: Menambahkan routingSummaries dalam 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 tempat asal ke tempat, dan satu dari tempat ke tujuan.
directions_uri

string

Link untuk menampilkan rute di Google Maps menggunakan titik jalan dari ringkasan perutean yang diberikan. Rute yang dihasilkan oleh link ini tidak dijamin sama dengan rute yang digunakan untuk menghasilkan ringkasan perutean. Link ini menggunakan informasi yang diberikan dalam permintaan, dari kolom termasuk routingParameters dan searchAlongRouteParameters jika berlaku, untuk membuat link petunjuk arah.

Kaki

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

Kolom
duration

Duration

Waktu yang diperlukan untuk menyelesaikan bagian perjalanan ini.
distance_meters

int32

Jarak segmen perjalanan ini.

SearchNearbyRequest

Proto permintaan untuk Search Nearby.

Kolom
language_code

string

Detail tempat akan ditampilkan dalam 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 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.

Hingga 50 jenis dari Tabel A dapat ditentukan.

Jika ada jenis yang bertentangan, yaitu jenis 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 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.

Hingga 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. Respons mencakup tempat yang cocok dengan setidaknya salah satu included_types dan tidak cocok dengan excluded_types.

Jika ada jenis yang bertentangan, yaitu jenis 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 menyediakan layanan terkait "restoran", tetapi tidak beroperasi terutama sebagai "restoran".
included_primary_types[]

string

Jenis Tempat utama yang disertakan (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.

Hingga 50 jenis dari Tabel A dapat ditentukan.

Jika ada jenis utama yang bertentangan, yaitu jenis 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 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.

Hingga 50 jenis dari Tabel A dapat ditentukan.

Jika ada jenis utama yang bertentangan, yaitu jenis 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 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 angka tidak disetel, angka 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 perutean 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. Akan menggunakan peringkat berdasarkan POPULARITAS secara default.
DISTANCE Memeringkat hasil menurut jarak.
POPULARITY Memberi peringkat hasil menurut popularitas.

SearchNearbyResponse

Proto respons untuk Search Nearby.

Kolom
places[]

Place

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

RoutingSummary

Daftar ringkasan perutean dengan setiap entri dikaitkan dengan tempat yang sesuai dalam indeks yang sama di kolom places. Jika ringkasan perutean 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 dalam 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 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 rating pengguna rata-ratanya kurang dari batas ini. Nilai yang valid harus berupa float antara 0 dan 5 (inklusif) pada irama 0,5, yaitu [0, 0,5, 1,0, ..., 5,0] secara inklusif. Rating input akan dibulatkan ke atas ke 0,5 terdekat(pembulatan ke atas). Misalnya, rating 0,6 akan menghilangkan 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 selanjutnya. 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 selanjutnya. 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 selanjutnya.

Saat melakukan penomoran halaman, semua parameter selain page_token, page_size, dan max_result_count yang diberikan ke TextSearch harus sesuai 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. Default untuk memilih semua tingkat harga.
strict_type_filtering

bool

Digunakan untuk menyetel pemfilteran jenis ketat untuk included_type. Jika disetel ke benar (true), hanya hasil dengan 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 dapat ditampilkan. Tidak dapat disetel bersama dengan location_restriction.
location_restriction

LocationRestriction

Wilayah yang akan ditelusuri. Lokasi ini berfungsi sebagai batasan yang berarti hasil di luar lokasi yang diberikan tidak akan ditampilkan. Tidak dapat disetel 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 merutekan ke hasil.
search_along_route_parameters

SearchAlongRouteParameters

Opsional. Proto parameter tambahan untuk menelusuri sepanjang rute.
include_pure_service_area_businesses

bool

Opsional. Sertakan bisnis jasa sistem panggilan murni jika kolom ditetapkan ke benar (true). 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 yang dapat ditelusuri dari permintaan penelusuran tempat.

Kolom
minimum_charging_rate_kw

double

Opsional. Kecepatan pengisian daya minimum yang diperlukan dalam kilowatt. Tempat dengan kecepatan pengisian daya yang lebih rendah dari kecepatan yang ditentukan akan difilter.
connector_types[]

EVConnectorType

Opsional. Daftar jenis konektor EV pilihan. 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 dapat 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 tampilan persegi panjang. rectangle.low() harus berupa titik barat daya area tampilan persegi panjang. rectangle.low().latitude() tidak boleh lebih besar dari rectangle.high().latitude(). Hal ini akan menghasilkan rentang lintang yang 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 yang diberikan 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 tampilan persegi panjang. rectangle.low() harus berupa titik barat daya area tampilan persegi panjang. rectangle.low().latitude() tidak boleh lebih besar dari rectangle.high().latitude(). Hal ini akan menghasilkan rentang lintang yang 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 defaultnya. Untuk kueri non-kategoris seperti "Mountain View, CA", sebaiknya Anda membiarkan rankPreference tidak ditetapkan.
DISTANCE Memeringkat hasil menurut jarak.
RELEVANCE Memberi peringkat 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 dicari. Menelusuri di sepanjang rute serupa dengan menggunakan opsi permintaan locationBias atau locationRestriction untuk memengaruhi hasil penelusuran. Namun, meskipun opsi locationBias dan locationRestriction memungkinkan Anda menentukan wilayah untuk memengaruhi hasil penelusuran, opsi ini memungkinkan Anda memengaruhi 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 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 perutean dengan setiap entri dikaitkan dengan tempat yang sesuai dalam indeks yang sama di kolom places. Jika ringkasan perutean 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 dikaitkan dengan 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. Array ini akan kosong hanya 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 selanjutnya.
search_uri

string

Link memungkinkan pengguna menelusuri dengan kueri teks yang sama seperti yang ditentukan dalam permintaan di Google Maps.

TravelMode

Opsi mode perjalanan. Opsi ini dipetakan ke Routes API yang ditawarkan.

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 Bepergian dengan berjalan kaki. Tidak didukung dengan search_along_route_parameters.
TWO_WHEELER Kendaraan roda dua bermotor dari segala jenis seperti skuter dan sepeda motor. Perhatikan bahwa ini berbeda dengan mode perjalanan BICYCLE yang mencakup transportasi bertenaga manusia. Tidak didukung dengan search_along_route_parameters. Hanya didukung di negara-negara yang tercantum di Negara dan wilayah yang didukung untuk kendaraan roda dua.