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

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

Mendapatkan media foto dengan string referensi foto.
GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

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

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

Menelusuri tempat di dekat lokasi.
SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

Kueri teks berdasarkan penelusuran tempat.

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 digunakan untuk menelusuri.
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 menjadi bias berdasarkan alamat IP, yang berarti alamat IP akan dipetakan ke lokasi yang tidak akurat dan digunakan sebagai sinyal yang membiaskan.
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 menjadi bias berdasarkan alamat IP, yang berarti alamat IP akan dipetakan ke lokasi yang tidak akurat dan digunakan sebagai sinyal yang membiaskan.
included_primary_types[]

string

Opsional. Jenis Tempat utama yang disertakan (misalnya, "restaurant" atau "gas_station") dari https://developers.google.com/maps/documentation/places/web-service/place-types. Tempat hanya ditampilkan jika jenis utamanya disertakan dalam daftar ini. Anda dapat menentukan hingga 5 nilai. Jika tidak ada jenis yang ditentukan, semua jenis Tempat akan ditampilkan.
included_region_codes[]

string

Opsional. Hanya sertakan hasil di wilayah yang ditentukan, yang ditetapkan sebagai maksimum 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 akan digunakan untuk menampilkan hasil. Default-nya adalah en-US. Hasilnya mungkin dalam bahasa campuran jika bahasa yang digunakan dalam input berbeda dengan language_code atau jika Tempat yang ditampilkan tidak memiliki terjemahan dari bahasa lokal ke bahasa language_code.
region_code

string

Opsional. Kode wilayah, ditetapkan sebagai kode wilayah dua karakter CLDR. Hal ini mempengaruhi pemformatan alamat, peringkat hasil, dan dapat mempengaruhi hasil yang dimunculkan. Tindakan ini tidak membatasi hasil pada wilayah yang ditentukan. Untuk membatasi hasil ke suatu wilayah, gunakan region_code_restriction.
origin

LatLng

Opsional. Titik asal untuk menghitung jarak geodesi ke tujuan (ditampilkan sebagai distance_meters). Jika nilai ini dihilangkan, jarak geodesi 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, panjang defaultnya adalah 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 Autocomplete 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, lalu panggilan ke Place Details atau Validasi Alamat dilakukan. Setiap sesi dapat memiliki beberapa kueri, diikuti dengan satu permintaan Place Details atau Validasi Alamat. Kredensial yang digunakan untuk setiap permintaan dalam suatu 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 Validasi Alamat dalam sebuah sesi termasuk dalam project Konsol Cloud yang sama.
  • Pastikan untuk meneruskan token sesi yang unik untuk setiap sesi baru. Jika Anda menggunakan token yang sama untuk lebih dari satu sesi, setiap permintaan akan ditagih satu per satu.

LocationBias

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

Kolom

Kolom union type.

type hanya dapat berupa salah satu dari yang 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 yang 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 yang berikut:
place_prediction

PlacePrediction

Prediksi untuk Tempat.
query_prediction

QueryPrediction

Prediksi untuk kueri.

FormattableText

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

Kolom
text

string

Teks yang dapat digunakan sebagaimana adanya atau diformat dengan matches.
matches[]

StringRange

Daftar rentang string yang mengidentifikasi tempat permintaan input cocok di text. Rentang ini 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 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 dalam API lain yang menerima nama Tempat.
place_id

string

ID unik untuk 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 usaha, biasanya berupa nama dan alamat bisnis.

text direkomendasikan untuk developer yang ingin menampilkan satu elemen UI. Developer yang ingin menampilkan dua elemen UI yang terpisah, tetapi berkaitan, dapat menggunakan structured_format. Keduanya adalah cara yang 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 menggunakan bahasa yang berbeda atau jika Tempat tidak memiliki terjemahan dari bahasa lokal ke bahasa language_code.
structured_format

StructuredFormat

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

structured_format direkomendasikan untuk developer yang ingin menampilkan dua elemen UI yang terpisah, tetapi terkait. Developer yang ingin menampilkan satu elemen UI dapat menggunakan text. Keduanya adalah cara yang 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 bersama 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 Query Autocomplete.

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 berkaitan, dapat menggunakan structured_format. Keduanya adalah cara yang 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 menggunakan bahasa yang berbeda atau jika bagian kueri tidak memiliki terjemahan dari bahasa lokal ke bahasa language_code.
structured_format

StructuredFormat

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

structured_format direkomendasikan untuk developer yang ingin menampilkan dua elemen UI yang terpisah, tetapi terkait. Developer yang ingin menampilkan satu elemen UI dapat menggunakan text. Keduanya adalah cara yang 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 utamanya berisi nama spesifik Tempat. Untuk prediksi kueri, teks utama berisi kueri.

Teks sekunder berisi fitur tambahan yang membedakan (seperti kota atau wilayah) untuk mengidentifikasi Tempat lebih lanjut atau menyaring kueri.

Kolom
main_text

FormattableText

Menunjukkan 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 lintang harus dalam [-90.0, 90.0]. Rentang bujur harus 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 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 detail selengkapnya.

Konten yang kontekstual dengan kueri tempat.

Kolom
reviews[]

Review

Daftar ulasan tentang tempat ini, berlanjut dengan kueri tempat.
photos[]

Photo

Informasi (termasuk referensi) tentang foto tempat ini, beserta kueri tempat.
justifications[]

Justification

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

Justifikasi untuk tempat.

Pembenaran

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

Justifikasi untuk tempat. Justifikasi menjawab pertanyaan tentang mengapa suatu tempat dapat menarik minat pengguna akhir.

Kolom

Kolom union justification.

justification hanya dapat berupa salah satu dari yang berikut:
review_justification

ReviewJustification

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

BusinessAvailabilityAttributesJustification

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

BusinessAvailabilityAttributesJustification

Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk detail selengkapnya. Justifikasi BusinessAvailabilityAttributes. Diagram ini menunjukkan beberapa atribut yang dimiliki bisnis yang dapat menarik minat pengguna akhir.

Kolom
takeout

bool

Apakah ada tempat yang menyediakan layanan bawa pulang.
delivery

bool

Apakah tempat yang menyediakan layanan pesan antar.
dine_in

bool

Apakah tempat menyediakan layanan makan di tempat.

ReviewJustification

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

Justifikasi peninjauan pengguna. Fitur ini menyoroti bagian ulasan pengguna yang akan menarik minat pengguna akhir. Misalnya, jika kueri penelusuran adalah "firewood pizza", justifikasi peninjauan akan menandai teks yang relevan dengan kueri penelusuran tersebut.

Kolom
highlighted_text

HighlightedText
review

Review

Ulasan yang menghasilkan teks yang ditandai.

HighlightedText

Teks yang ditandai dengan justifikasi. Ini adalah bagian dari ulasan itu sendiri. Kata persis yang perlu ditandai ditandai dengan 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 berikut https://afdc.energy.gov/fuels/electricity_infrastructure.html Satu port dapat mengisi daya satu mobil pada 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 (mis.) 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 kecepatan pengisian daya yang sama.

ConnectorAggregation

Informasi pengisian daya kendaraan listrik dikelompokkan menurut [type, max_charge_rate_kw]. Menampilkan agregasi pengisian daya EV dari konektor yang memiliki jenis dan tingkat pengisian daya maksimum yang sama dalam kw.

Kolom
type

EVConnectorType

Jenis konektor agregasi ini.
max_charge_rate_kw

double

Rasio pengisian daya maksimum statis dalam kw 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 berfungsi.

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 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 Sistem Pengisian Daya Gabungan (AC dan DC). Berdasarkan SAE. Konektor J-1772 Tipe-1
EV_CONNECTOR_TYPE_CCS_COMBO_2 Sistem Pengisian Daya Gabungan (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 Kombo 2 (CCS2) atau GB/T). Nilai ini kurang mewakili jenis konektor sebenarnya, dan lebih mewakili kemampuan untuk mengisi daya kendaraan bermerek Tesla di SPKLU 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.

FuelOptions

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

Kolom
fuel_prices[]

FuelPrice

Harga bahan bakar yang diketahui terakhir untuk setiap jenis bahan bakar yang dimiliki SPBU ini. Ada satu tiket masuk 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 belum ditetapkan.
DIESEL Bahan bakar diesel.
REGULAR_UNLEADED Reguler tanpa timbal.
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 LPG.
E80 E 80.
E85 E 85.
METHANE Metana.
BIO_DIESEL Bio-diesel.
TRUCK_DIESEL Truk diesel.

GetPhotoMediaRequest

Permintaan untuk mengambil foto tempat menggunakan nama aset foto.

Kolom
name

string

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

Nama resource foto seperti yang ditampilkan dalam kolom photos.name objek Tempat dilengkapi dengan 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, untuk 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 ukuran yang lebih kecil di antara dua dimensi, yang dibatasi sesuai rasio aspek aslinya. Properti max_height_px dan max_width_px menerima bilangan bulat antara 1 dan 4800, secara 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, untuk 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 ukuran yang lebih kecil di antara dua dimensi, yang dibatasi sesuai rasio aspek aslinya. Properti max_height_px dan max_width_px menerima bilangan bulat antara 1 dan 4800, secara 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 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 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 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 (CLDR) Unicode tempat lokasi permintaan berasal. Parameter ini digunakan untuk menampilkan detail tempat, seperti nama tempat spesifik per wilayah, jika tersedia. Parameter ini dapat memengaruhi hasil berdasarkan hukum yang berlaku. Untuk mengetahui 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 maksimal 36 karakter ASCII. Jika tidak, error INVALID_ARGUMENT akan ditampilkan.

Sesi dimulai saat pengguna mulai mengetik kueri, dan berakhir saat mereka memilih tempat, lalu panggilan ke Place Details atau Validasi Alamat dilakukan. Setiap sesi dapat memiliki beberapa kueri, diikuti dengan satu permintaan Place Details atau Validasi Alamat. Kredensial yang digunakan untuk setiap permintaan dalam suatu 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 Validasi Alamat dalam sebuah sesi termasuk dalam project Konsol Cloud yang sama.
  • Pastikan untuk meneruskan token sesi yang unik untuk setiap sesi baru. Jika Anda menggunakan token yang sama untuk lebih dari satu sesi, setiap permintaan akan ditagih satu per satu.

Foto

Informasi tentang foto sebuah tempat.

Kolom
name

string

Pengenal. Referensi yang mewakili foto tempat ini, yang mungkin digunakan untuk mencari foto tempat ini lagi (juga disebut nama "sumber daya" 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.

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 merepresentasikan Tempat.

Kolom
name

string

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

string

ID unik suatu tempat.
display_name

LocalizedText

Nama tempat yang dilokalkan, sesuai sebagai deskripsi singkat yang dapat dibaca manusia. Misalnya, "Google Sydney", "Starbucks", "Pyrmont", dll.
types[]

string

Sekumpulan tag jenis untuk hasil ini. Misalnya, "politik" dan "lokalitas". Untuk 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 dari hasil yang diberikan. Jenis ini harus merupakan salah satu jenis yang didukung Places API. Misalnya, "restoran", "kafe", "bandara", dll. Sebuah tempat hanya dapat memiliki satu jenis utama. Untuk 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 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 orang untuk tempat ini.
short_formatted_address

string

Alamat singkat yang dapat dibaca orang untuk tempat ini.
address_components[]

AddressComponent

Komponen berulang untuk setiap tingkat lokalitas. Perhatikan fakta berikut tentang array address_components[]: - Array komponen alamat mungkin berisi lebih banyak komponen daripada format_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 untuk lintang/bujur lokasi tempat.
location

LatLng

Posisi tempat ini.
viewport

Viewport

Area pandang yang cocok untuk menampilkan tempat pada peta berukuran rata-rata.
rating

double

Rating antara 1,0 dan 5,0, berdasarkan ulasan pengguna 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 suatu jaringan bisnis (misalnya, toko IKEA), biasanya berupa situs untuk toko tersebut, bukan keseluruhan jaringan bisnis tersebut.
reviews[]

Review

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

OpeningHours

Jam operasional reguler.
photos[]

Photo

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

string

Alamat tempat tersebut dalam adr microformat: 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 bersama hasil ini.
icon_mask_base_uri

string

URL yang terpotong ke mask ikon. Pengguna dapat mengakses jenis ikon yang berbeda dengan menambahkan akhiran jenis ke 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 operasional selama tujuh hari ke depan (termasuk hari ini). Jangka waktu tersebut 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 buka yang ditetapkan untuk tanggal yang memiliki jam luar biasa.
current_secondary_opening_hours[]

OpeningHours

Berisi array entri untuk tujuh hari ke depan termasuk informasi tentang jam buka sekunder bisnis. Jam sekunder berbeda dari jam buka utama bisnis. Misalnya, restoran dapat menentukan jam drive-through atau jam pengiriman sebagai jam sekunder. Kolom ini mengisi subkolom jenis, yang diambil dari daftar jenis jam buka yang ditentukan sebelumnya (seperti DRIVE_SMS, PICKUP, atau takeOUT) berdasarkan jenis tempat. Kolom ini mencakup subkolom special_days dari semua jam buka yang ditetapkan untuk tanggal yang memiliki jam luar biasa.
regular_secondary_opening_hours[]

OpeningHours

Berisi array entri untuk informasi tentang jam sekunder reguler bisnis. Jam sekunder berbeda dari jam buka utama bisnis. Misalnya, restoran dapat menentukan jam drive-through atau jam pengiriman sebagai jam sekunder. Kolom ini mengisi subkolom jenis, yang diambil dari daftar jenis jam buka yang ditentukan sebelumnya (seperti DRIVE_SMS, PICKUP, atau takeOUT) berdasarkan jenis tempat.
editorial_summary

LocalizedText

Berisi ringkasan tempat. Ringkasan terdiri dari ringkasan tekstual, dan juga menyertakan kode bahasa untuk ini jika berlaku. Teks ringkasan harus disajikan apa adanya dan tidak dapat dimodifikasi atau diubah.
payment_options

PaymentOptions

Opsi pembayaran yang diterima tempat tersebut. Jika data opsi pembayaran tidak tersedia, kolom opsi pembayaran akan dibatalkan penetapannya.
parking_options

ParkingOptions

Opsi parkir yang disediakan oleh tempat tersebut.
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 terbaru.
generative_summary

GenerativeSummary

Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk 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 detail selengkapnya.

Ringkasan area yang dibuat AI tentang area tersebut.
utc_offset_minutes

int32

Selisih jumlah menit antara zona waktu tempat ini saat ini dari UTC. Hal 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 pengeksporan.
delivery

bool

Menentukan apakah bisnis mendukung layanan pesan antar.
dine_in

bool

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

bool

Menentukan apakah bisnis mendukung opsi ambil di tepi jalan.
reservable

bool

Menentukan apakah tempat mendukung reservasi.
serves_breakfast

bool

Menentukan apakah tempat 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 menyajikan anggur.
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 menyediakan musik live.
menu_for_children

bool

Tempat ini memiliki menu anak-anak.
serves_cocktails

bool

Tempat menyajikan koktail.
serves_dessert

bool

Tempat ini menyajikan hidangan pencuci mulut.
serves_coffee

bool

Tempat menyajikan kopi.
good_for_children

bool

Tempat ini cocok untuk anak-anak.
allows_dogs

bool

{i>Place <i}memungkinkan {i>dogs<i}.
restroom

bool

Tempat ini memiliki toilet.
good_for_groups

bool

Tempat mengakomodasi grup.
good_for_watching_sports

bool

Tempat ini cocok untuk menonton acara olahraga.
accessibility_options

AccessibilityOptions

Informasi tentang opsi aksesibilitas yang ditawarkan tempat.

AccessibilityOptions

Informasi tentang opsi aksesibilitas yang ditawarkan tempat.

Kolom
wheelchair_accessible_parking

bool

Place 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 memiliki 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 dari "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 detail selengkapnya.

Ringkasan area yang dibuat AI tentang area tersebut.

Kolom
content_blocks[]

ContentBlock

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

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 usaha tutup permanen.

GenerativeSummary

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

Ringkasan tempat yang dibuat AI.

Kolom
overview

LocalizedText

Ringkasan tempat.
description

LocalizedText

Deskripsi mendetail tentang tempat.
references

References

Referensi yang digunakan untuk menghasilkan deskripsi ringkasan.

OpeningHours

Informasi tentang jam buka tempat.

Kolom
periods[]

Period

Periode tempat ini buka selama seminggu. Periode ini diurutkan secara kronologis, dimulai dari hari Minggu di zona waktu tempat-tempat lokal. Nilai kosong (tetapi tidak ada) menunjukkan tempat yang tidak pernah buka, misalnya karena tutup 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 buka tidak diketahui atau tidak dapat dikonversi ke teks yang dilokalkan. Contoh: "Sun: 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 berada 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 khusus.
open_now

bool

Apakah tempat ini buka sekarang? Selalu ada kecuali jika kami tidak memiliki data waktu atau zona waktu untuk jam buka ini.

Periode

Periode tempat tetap dalam status open_now.

Kolom
open

Point

Waktu tempat mulai buka.
close

Point

Waktu tempat mulai tutup.

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 ketika jam sebenarnya berada di luar waktu yang ingin kami kembalikan, jadi kami memotong jam kembali ke batas tersebut. Hal ini memastikan bahwa paling banyak 24 * 7 jam dari tengah malam pada hari permintaan dikembalikan.
day

int32

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

int32

Jam dalam 2 digit. Rentang dari 00 hingga 23.
minute

int32

Menit dalam 2 digit. Rentang dari 00 hingga 59.

SecondaryHoursType

Jenis yang digunakan untuk mengidentifikasi jenis jam buka sekunder.

Enum
SECONDARY_HOURS_TYPE_UNSPECIFIED Nilai default saat jenis jam sekunder tidak ditentukan.
DRIVE_THROUGH Jam drive-through untuk bank, restoran, atau apotek.
HAPPY_HOUR Waktu senang-senang.
DELIVERY Jam pengiriman.
TAKEOUT Jam layanan bawa pulang.
KITCHEN Jam memasak.
BREAKFAST Jam sarapan.
LUNCH Jam makan siang.
DINNER Jam makan malam.
BRUNCH Jam sarapan siang.
PICKUP Waktu penjemputan.
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 berada 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

Place menawarkan tempat parkir gratis.
paid_parking_lot

bool

Tempat ini menawarkan tempat parkir berbayar.
free_street_parking

bool

Place menawarkan parkir di pinggir jalan gratis.
paid_street_parking

bool

Place menawarkan parkir di pinggir jalan berbayar.
valet_parking

bool

Tempat menawarkan parkir valet.
free_garage_parking

bool

Place menawarkan parkir di garasi gratis.
paid_garage_parking

bool

Tempat menawarkan parkir berbayar di garasi.

PaymentOptions

Opsi pembayaran yang diterima tempat tersebut.

Kolom
accepts_credit_cards

bool

Tempatkan kartu kredit sebagai pembayaran.
accepts_debit_cards

bool

Place menerima kartu debit sebagai pembayaran.
accepts_cash_only

bool

Place hanya menerima uang tunai sebagai pembayaran. Tempat dengan atribut ini mungkin masih menerima metode pembayaran lain.
accepts_nfc

bool

Place menerima pembayaran NFC.

PlusCode

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

Kolom
global_code

string

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

string

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

SubDestination

Tempatkan nama resource dan id sub-tujuan yang berhubungan dengan tempat. Misalnya, terminal yang berbeda adalah tujuan yang berbeda dari sebuah bandara.

Kolom
name

string

Nama resource sub-tujuan.
id

string

ID tempat sub-tujuan.

PriceLevel

Tingkat harga tempat.

Enum
PRICE_LEVEL_UNSPECIFIED Tingkat harga tempat tidak ditentukan atau tidak diketahui.
PRICE_LEVEL_FREE Place menyediakan layanan gratis.
PRICE_LEVEL_INEXPENSIVE Place menyediakan layanan murah.
PRICE_LEVEL_MODERATE Place menyediakan layanan dengan harga menengah.
PRICE_LEVEL_EXPENSIVE Place menyediakan layanan yang mahal.
PRICE_LEVEL_VERY_EXPENSIVE Place menyediakan layanan yang sangat mahal.

Referensi

Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk 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 Tempat.

Tinjau

Informasi tentang ulasan suatu tempat.

Kolom
name

string

Referensi yang mewakili ulasan tempat ini, yang mungkin 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, 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, juga disebut jumlah bintang.
author_attribution

AuthorAttribution

Penulis ulasan ini.
publish_time

Timestamp

Stempel waktu untuk peninjauan.

SearchNearbyRequest

Meminta proto untuk Search Nearby.

Kolom
language_code

string

Detail tempat akan ditampilkan dalam bahasa pilihan jika tersedia. Jika kode bahasa tidak ditentukan atau tidak dikenal, detail tempat untuk bahasa apa pun dapat ditampilkan, dengan preferensi bahasa Inggris jika ada detail tersebut.

Daftar bahasa yang didukung saat ini: https://developers.google.com/maps/faq#languagesupport.
region_code

string

Kode negara/wilayah (CLDR) Unicode tempat lokasi permintaan berasal. Parameter ini digunakan untuk menampilkan detail tempat, seperti nama tempat spesifik per wilayah, jika tersedia. Parameter ini dapat memengaruhi hasil berdasarkan hukum yang berlaku.

Untuk mengetahui 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 muncul dalam include_types danexcluded_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 "restaurant" tetapi tidak beroperasi terutama sebagai "restaurant".
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 include_types (mis. restoran) dan {i>excluded_types<i} (misalnya kafe), respons harus menyertakan tempat yang merupakan restoran tetapi bukan kafe. Responsnya menyertakan tempat yang cocok dengan setidaknya salah satu penyertaan yang termasuk dan tidak satu pun dari jenis_yang_dikecualikan.

Jika ada jenis yang bertentangan, yaitu jenis muncul dalam include_types danexcluded_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 "restaurant" tetapi tidak beroperasi terutama sebagai "restaurant".
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 dan terkait dengannya.

Maksimal 50 jenis dari Tabel A dapat ditentukan.

Jika ada jenis utama yang bertentangan, yaitu jenis yang muncul di include_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 "restaurant" tetapi tidak beroperasi terutama sebagai "restaurant".
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 include_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 "restaurant" tetapi tidak beroperasi terutama sebagai "restaurant".
max_result_count

int32

Jumlah hasil maksimum yang akan ditampilkan. Nilainya harus antara 1 dan 20 (default), secara inklusif. Jika tidak disetel, angka ini 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.

LocationRestriction

Wilayah yang akan ditelusuri.

Kolom

Kolom union type.

type hanya dapat berupa salah satu dari yang 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 belum ditetapkan. Akan menggunakan peringkat menurut POPULARITAS secara default.
DISTANCE Menentukan peringkat hasil menurut jarak.
POPULARITY Memberi peringkat hasil berdasarkan popularitas.

SearchNearbyResponse

Proto respons untuk Search Nearby.

Kolom
places[]

Place

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

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 dikenal, detail tempat untuk bahasa apa pun dapat ditampilkan, dengan preferensi bahasa Inggris jika ada detail tersebut.

Daftar bahasa yang didukung saat ini: https://developers.google.com/maps/faq#languagesupport.
region_code

string

Kode negara/wilayah (CLDR) Unicode tempat lokasi permintaan berasal. Parameter ini digunakan untuk menampilkan detail tempat, seperti nama tempat spesifik per wilayah, jika tersedia. Parameter ini dapat memengaruhi hasil berdasarkan hukum yang berlaku.

Untuk mengetahui 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

Filter hasil yang rating pengguna rata-ratanya benar-benar kurang dari batas ini. Nilai yang valid harus berupa float antara 0 dan 5 (inklusif) pada ritme 0,5 yaitu [0, 0,5, 1,0, ... , 5,0] secara inklusif. Rating input akan dibulatkan ke 0,5(plafon) terdekat. Misalnya, peringkat 0,6 akan menghilangkan semua hasil dengan peringkat kurang dari 1,0.
max_result_count
(deprecated)

int32

Tidak digunakan lagi: Sebagai gantinya, gunakan page_size.

Jumlah hasil maksimum 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 hasil maksimum 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 default untuk memilih semua tingkat harga.
strict_type_filtering

bool

Digunakan untuk menetapkan pemfilteran jenis yang ketat untuk include_type. Jika disetel ke benar (true), hanya hasil dari jenis yang sama yang akan ditampilkan. Nilai defaultnya adalah false (salah).
location_bias

LocationBias

Wilayah yang akan ditelusuri. Lokasi ini berfungsi sebagai bias yang berarti hasil di sekitar lokasi yang diberikan mungkin akan ditampilkan. Tidak dapat ditetapkan bersama location_restriction.
location_restriction

LocationRestriction

Wilayah yang akan ditelusuri. Lokasi ini berfungsi sebagai pembatasan yang berarti hasil di luar lokasi yang ditentukan tidak akan ditampilkan. Tidak dapat ditetapkan bersama location_bias.
ev_options

EVOptions

Opsional. Menyetel opsi kendaraan listrik yang dapat ditelusuri dari permintaan penelusuran tempat.

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 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 yang diberikan mungkin akan ditampilkan.

Kolom

Kolom union type.

type hanya dapat berupa salah satu dari yang berikut:
rectangle

Viewport

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

Circle

Lingkaran yang ditentukan oleh titik tengah dan radius.

LocationRestriction

Wilayah yang akan ditelusuri. Lokasi ini berfungsi sebagai pembatasan yang berarti hasil di luar lokasi yang ditentukan tidak akan ditampilkan.

Kolom

Kolom union type.

type hanya dapat berupa salah satu dari yang berikut:
rectangle

Viewport

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

RankPreference

Cara hasil akan diberi peringkat dalam respons.

Enum
RANK_PREFERENCE_UNSPECIFIED Untuk kueri kategori seperti "Restoran di Bandung", RELEVANCE adalah setelan default. Untuk kueri non-kategori seperti "Jakarta, CA", sebaiknya Anda tidak menetapkan RankPreference.
DISTANCE Menentukan peringkat hasil menurut jarak.
RELEVANCE Memberi peringkat hasil menurut relevansi. Urutan penyortiran yang ditentukan oleh tumpukan peringkat normal.

SearchTextResponse

Proto respons untuk SearchText.

Kolom
places[]

Place

Daftar tempat yang memenuhi kriteria penelusuran teks pengguna.
contextual_contents[]

ContextualContent

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

Daftar konten kontekstual dengan setiap entri terkait dengan tempat yang sesuai dalam indeks yang sama di kolom tempat. Konten yang relevan dengan text_query dalam permintaan lebih disarankan. 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 harus 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 akan ada halaman berikutnya.