Package google.maps.geocode.v4alpha

Indeks

DestinationService

Layanan untuk mengambil tujuan.

Tujuan memberikan konteks hierarkis tentang suatu tempat, yang memungkinkan Anda, misalnya, menemukan gedung apartemen dalam kompleks apartemen yang lebih besar dan sebaliknya. API ini juga menyediakan titik navigasi yang sesuai untuk kasus penggunaan seperti transportasi online atau pengiriman.

SearchDestinations

rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse)

Metode ini melakukan pencarian tujuan dan menampilkan daftar tujuan.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

GeocodeService

Layanan untuk melakukan geocoding.

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

Metode ini melakukan geocoding alamat, yang memetakan alamat ke LatLng. Fitur ini juga memberikan informasi terstruktur tentang alamat.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.address
GeocodeLocation

rpc GeocodeLocation(GeocodeLocationRequest) returns (GeocodeLocationResponse)

Metode ini melakukan geocoding lokasi, yang memetakan LatLng ke alamat. Fitur ini juga memberikan informasi terstruktur tentang alamat.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.location
GeocodePlace

rpc GeocodePlace(GeocodePlaceRequest) returns (GeocodeResult)

Metode ini melakukan pencarian geocode menggunakan ID tempat.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Destination

Tujuan. Hal ini mencakup tempat utama, tempat terkait, pintu masuk, dan titik navigasi.

Kolom
primary

PlaceView

Tempat utama yang diidentifikasi oleh primary_query dalam permintaan.
containing_places[]

PlaceView

Tempat yang kurang akurat yang berisi tempat utama. Misalnya, kompleks apartemen yang berisi bangunan ini.
sub_destinations[]

PlaceView

Sub-tujuan yang lebih presisi dari tempat utama. Misalnya, unit yang terdapat dalam bangunan.

Catatan: dibandingkan dengan SubDestination yang ditampilkan oleh Places API, daftar sub-tujuan ini lebih lengkap, dan setiap sub-tujuan berisi lebih banyak informasi.
landmarks[]

Landmark

Tempat terkenal yang dapat digunakan untuk menginformasikan lokasi tujuan atau membantu kedatangan.
entrances[]

Entrance

Pintu masuk untuk tujuan ini.
navigation_points[]

NavigationPoint

Titik navigasi untuk tujuan ini.
parking_options

Destination.ParkingOptions

Opsi parkir untuk tujuan ini.
arrival_summary

Destination.ArrivalSummary

Ringkasan yang dibuat AI tentang pengalaman kedatangan di tujuan.

ArrivalSummary

Ringkasan yang dibuat AI tentang pengalaman kedatangan di tujuan.

Kolom
text

LocalizedText

Ringkasan pengalaman kedatangan di tujuan.
flag_content_url

string

Link tempat pengguna dapat melaporkan masalah terkait ringkasan.
disclosure_text

LocalizedText

Hanya output. Berisi teks pengungkapan untuk ringkasan kedatangan.

ParkingOptions

Informasi tentang opsi parkir untuk tujuan.

Kolom
availability

Destination.ParkingOptions.Availability

Ketersediaan tempat parkir untuk tujuan ini.
parking_facilities[]

Destination.ParkingOptions.ParkingFacility

Fasilitas parkir untuk tujuan ini.
onsite_parking

bool

Tempat parkir tersedia di tujuan.
free_parking_lot

bool

Menyediakan tempat parkir gratis.
paid_parking_lot

bool

Menawarkan tempat parkir berbayar.
free_street_parking

bool

Menawarkan tempat parkir di pinggir jalan gratis.
paid_street_parking

bool

Menawarkan tempat parkir di pinggir jalan berbayar.
valet_parking

bool

Menawarkan parkir valet.
free_garage_parking

bool

Menyediakan tempat parkir di garasi gratis.
paid_garage_parking

bool

Menawarkan tempat parkir di garasi berbayar.

Ketersediaan

Ukuran gabungan seberapa sulit menemukan tempat parkir saat mengunjungi tempat ini.

Nilai baru mungkin akan ditambahkan pada masa mendatang.

Enum
AVAILABILITY_UNSPECIFIED Ketersediaan tempat parkir tidak tersedia.
PLENTY Tersedia banyak tempat parkir.
SOMEWHAT_DIFFICULT Tempat parkir agak sulit ditemukan.
DIFFICULT Tempat parkir sangat sulit ditemukan.

ParkingFacility

Opsi parkir terpisah dan individual (misalnya, gedung parkir atau tempat parkir tertentu) yang terkait dengan tujuan. Pesan ini memberikan informasi mendetail tentang fasilitas parkir tertentu, sedangkan pesan ParkingOptions induk memberikan ringkasan gabungan dari semua tempat parkir yang tersedia.

Kolom
place

PlaceView

Representasi tempat dari fasilitas parkir tertentu ini.
onsite

bool

Apakah fasilitas parkir ini terletak di lokasi tujuan utama. Jika kolom ini tidak ditetapkan, status di lokasi tidak diketahui.
popular

bool

Apakah fasilitas parkir ini merupakan pilihan populer bagi pengunjung yang bepergian ke tujuan utama. Jika kolom ini tidak ditetapkan, status popularitas tidak diketahui.
straight_line_distance_meters

double

Jarak garis lurus dalam meter dari tujuan utama ke fasilitas parkir ini.

Pintu Masuk

Pintu masuk adalah satu pasangan koordinat lintang/bujur yang menentukan lokasi titik masuk dan keluar untuk suatu tempat.

Kolom
display_name

LocalizedText

Nama yang dapat dibaca manusia, misalnya, "Gerbang B", "Pintu Masuk Selatan", "Pintu Masuk 5th Ave".
location

LatLng

Lokasi pintu masuk.
tags[]

Entrance.Tag

Daftar tag yang mendeskripsikan pintu masuk.
place

string

Struktur tempat pintu masuk ini berada secara fisik, dalam format places/{place_id}.
street_view_thumbnail

StreetViewThumbnail

Gambar thumbnail Street View yang menampilkan pintu masuk. Gambar dapat diminta dari Street View Static API. Lihat https://developers.google.com/maps/documentation/streetview/request-streetview.
street_view_annotation

ImageAnnotation

Anotasi pintu masuk di street_view_thumbnail yang ditampilkan di atas.

Tag

Karakteristik yang mendeskripsikan pintu masuk.

Enum
TAG_UNSPECIFIED Tidak digunakan.
PREFERRED

Pintu masuk kemungkinan memberikan akses fisik ke tempat utama di tujuan yang ditampilkan. Suatu tempat dapat memiliki beberapa pintu masuk pilihan. Jika pintu masuk tidak memiliki tag ini, berarti pintu masuk tersebut secara fisik berada di bangunan yang sama dengan tempat utama, tetapi tidak selalu menyediakan akses ke tempat tersebut.

Misalnya, jika tempat utama adalah restoran di ruko, pintu masuk "PREFERRED" adalah pintu masuk yang kemungkinan mengarah ke restoran itu sendiri, sedangkan pintu masuk lain yang ditampilkan adalah pintu masuk lain untuk bangunan tersebut, seperti pintu masuk ke restoran lain di ruko.

Jika tempat utama adalah bangunan itu sendiri, pintu masuk PREFERRED akan menjadi pintu masuk yang mengarah ke bagian "utama" bangunan. Misalnya, di pusat perbelanjaan, pintu masuk PREFERRED adalah pintu masuk yang memungkinkan akses ke area lobi utama, tetapi jika pintu masuk hanya menyediakan akses ke toko di sisi bangunan, pintu masuk tersebut bukan pintu masuk PREFERRED.

Catatan: pintu masuk PREFERRED mungkin tidak menyediakan akses ke tempat utama, dan pintu masuk non-PREFERRED mungkin menyediakan akses ke tempat utama.

GeocodeAddressRequest

Pesan permintaan untuk GeocodeService.GeocodeAddress.

Kolom
location_bias

GeocodeAddressRequest.LocationBias

Opsional. Wilayah yang akan ditelusuri. Lokasi ini berfungsi sebagai bias, yang berarti hasil di sekitar lokasi yang diberikan akan lebih diutamakan.
language_code

string

Opsional. Bahasa yang digunakan untuk menampilkan hasil.
region_code

string

Opsional. Kode wilayah. Kode wilayah, yang ditetapkan sebagai nilai dua karakter ccTLD ("domain level teratas"). Parameter ini memengaruhi hasil berdasarkan hukum yang berlaku. Parameter ini juga akan memengaruhi, tetapi tidak sepenuhnya membatasi, hasil dari layanan.
Kolom union address_input. Alamat yang akan di-geocode. address_input hanya dapat berupa salah satu dari berikut:
address_query

string

Alamat tidak terstruktur yang akan di-geocode.
address

PostalAddress

Alamat terstruktur yang akan di-geocode dalam format alamat pos.

LocationBias

Wilayah yang akan ditelusuri. Lokasi ini berfungsi sebagai bias, yang berarti hasil di sekitar lokasi yang diberikan akan lebih diutamakan.

Kolom
Kolom union type. Jenis bias lokasi. type hanya dapat berupa salah satu dari berikut:
rectangle

Viewport

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

GeocodeAddressResponse

Pesan respons untuk GeocodeService.GeocodeAddress.

Kolom
results[]

GeocodeResult

Hasil geocoding.

GeocodeLocationRequest

Pesan permintaan untuk GeocodeService.GeocodeLocation.

Kolom
language_code

string

Opsional. Bahasa yang digunakan untuk menampilkan hasil.
region_code

string

Opsional. Kode wilayah. Kode wilayah, yang ditetapkan sebagai nilai dua karakter ccTLD ("domain level teratas"). Parameter ini memengaruhi hasil berdasarkan hukum yang berlaku.
types[]

string

Opsional. Kumpulan tag jenis untuk membatasi hasil. Hasil yang tidak memiliki jenis yang ditentukan akan dihapus.

Untuk mengetahui daftar lengkap nilai yang mungkin, lihat Tabel A dan Tabel B di https://developers.google.com/maps/documentation/places/web-service/place-types.
granularity[]

GeocodeResult.Granularity

Opsional. Filter dari satu atau beberapa enum perincian lokasi.
Kolom union location_input. Lokasi yang akan di-geocode. location_input hanya dapat berupa salah satu dari berikut:
location_query

string

Lokasi dalam format string "lat,lng". Misalnya, "64.7611872,-18.4705364".
location

LatLng

Lokasi dalam format terstruktur.

GeocodeLocationResponse

Pesan respons untuk GeocodeService.GeocodeLocation.

Kolom
results[]

GeocodeResult

Hasil geocoding.
plus_code

PlusCode

Plus code lokasi dalam permintaan.

GeocodePlaceRequest

Pesan permintaan untuk GeocodeService.GeocodePlace.

Kolom
place

string

Wajib. ID tempat yang akan di-geocode dalam format places/{place}.
language_code

string

Opsional. Bahasa yang digunakan untuk menampilkan hasil.
region_code

string

Opsional. Kode wilayah. Kode wilayah, yang ditetapkan sebagai nilai dua karakter ccTLD ("domain level teratas"). Parameter ini memengaruhi hasil berdasarkan hukum yang berlaku.

GeocodeResult

Hasil geocode berisi informasi geografis tentang suatu tempat.

Kolom
place

string

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

string

ID unik tempat.
location

LatLng

Lintang/bujur alamat ini.
granularity

GeocodeResult.Granularity

Perincian lokasi.
viewport

Viewport

Area pandang yang sesuai untuk menampilkan hasil geocode.
bounds

Viewport

Kotak pembatas untuk alamat.
formatted_address

string

Alamat berformat satu baris.
postal_address

PostalAddress

Alamat dalam format alamat pos.
address_components[]

GeocodeResult.AddressComponent

Komponen berulang untuk setiap tingkat lokalitas.
postal_code_localities[]

LocalizedText

Daftar lengkap lokalitas yang terdapat dalam kode pos.

Ini hanya diisi jika hasilnya berjenis "postal_code".
types[]

string

Serangkaian tag jenis untuk hasil ini. Misalnya, "political" dan "administrative_area".

Untuk mengetahui daftar lengkap nilai yang mungkin, lihat Tabel A dan Tabel B di https://developers.google.com/maps/documentation/places/web-service/place-types.
plus_code

PlusCode

Plus code lokasi dalam geocode ini.

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 mungkin memiliki nama panjang "Australia".
short_text

string

Nama tekstual yang disingkat untuk komponen alamat, jika tersedia. Misalnya, komponen alamat untuk negara Australia mungkin memiliki nama pendek "AU".
types[]

string

Array yang menunjukkan jenis komponen alamat.

Nilai ini diambil dari tabel Jenis alamat dan jenis komponen alamat yang digunakan oleh Places API: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types
language_code

string

Bahasa yang digunakan untuk memformat komponen ini, dalam notasi CLDR.

Perincian

Perincian lokasi.

Enum
GRANULARITY_UNSPECIFIED Jangan gunakan.
ROOFTOP Lokasi non-interpolasi dari sebidang tanah sebenarnya yang sesuai dengan alamat yang cocok.
RANGE_INTERPOLATED Diinterpolasi dari rentang nomor jalan. Misalnya, jika kita tahu bahwa segmen Amphitheatre Pkwy berisi nomor 1600 - 1699, maka 1650 mungkin ditempatkan di tengah-tengah antara titik akhirnya.
GEOMETRIC_CENTER Pusat geometris fitur yang memiliki data poligonal.
APPROXIMATE Semua yang lain.

ImageAnnotation

Anotasi pada thumbnail gambar, seperti poligon yang menguraikan pintu masuk.

Kolom
coordinates[]

ImageAnnotation.Coordinate

Daftar koordinat yang membentuk poligon pada gambar. Koordinat diurutkan berlawanan arah jarum jam.

Coordinate

Koordinat piksel titik pada gambar. Origin (0,0) adalah sudut kiri atas dari piksel kiri atas gambar, dengan sumbu x mengarah ke kanan dan sumbu y mengarah ke bawah.

Kolom
x_px

float

Koordinat x.
y_px

float

Koordinat y.

Penanda

Tempat terkenal digunakan untuk menginformasikan lokasi tujuan atau membantu pengguna tiba di tujuan.

Kolom
relational_description

LocalizedText

Deskripsi yang dapat dibaca manusia tentang hubungan tujuan dengan tempat terkenal. Misalnya: "Dekat Empire State Building" atau "Di seberang Gedung Putih".
tags[]

Landmark.Tag

Tag yang menjelaskan cara menggunakan tempat terkenal dalam konteks tujuan.
straight_line_distance_meters

double

Hanya output. Jarak garis lurus dari tempat terkenal ini ke tujuan dalam meter.
travel_distance_meters

double

Hanya output. Jarak berjalan kaki dari tempat terkenal ini ke tujuan dalam meter.
Kolom union landmark. Tempat terkenal. landmark hanya dapat berupa salah satu dari berikut:
place

PlaceView

Tempat yang mewakili tempat terkenal ini.

Tag

Daftar semua kemungkinan tag yang menjelaskan cara menggunakan tempat terkenal dalam konteks tujuan.

Jika alamat memiliki tag ADDRESS dan ARRIVAL, berarti tempat terkenal tersebut terkenal secara lokal dan dekat dengan tujuan.

Enum
TAG_UNSPECIFIED Tidak digunakan.
ADDRESS Tempat yang terkenal secara lokal yang dapat digunakan untuk mengidentifikasi lokasi umum tujuan. Biasanya dalam jarak beberapa ratus meter dari tujuan. Data ini mirip dengan tempat terkenal yang ditampilkan oleh fitur Deskripsi Alamat Geocoding API: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors.
ARRIVAL Tempat yang dapat digunakan untuk membantu tiba di tujuan. Berguna untuk navigasi setelah Anda berada di dekat tujuan. Misalnya, tempat terkenal ini mungkin adalah tempat yang berada di seberang jalan dari tujuan. Tempat terkenal dengan tag ini biasanya lebih dekat ke tujuan daripada tempat terkenal dengan tag ADDRESS.

Titik navigasi adalah lokasi di samping jalan tempat navigasi dapat berakhir.

Kolom
navigation_point_token

string

Hanya output. Token yang dapat digunakan untuk mengidentifikasi titik navigasi ini.
display_name

LocalizedText

Nama tampilan titik navigasi ini. Misalnya, "5th Ave" atau "Gate B".
location

LatLng

Titik di samping segmen jalan tempat navigasi harus berakhir. Titik ini sengaja sedikit digeser dari garis tengah jalan untuk menandai dengan jelas sisi jalan tempat lokasi berada.
travel_modes[]

NavigationPoint.TravelMode

Mode perjalanan yang sesuai untuk titik navigasi ini.
usages[]

NavigationPoint.Usage

Mencantumkan usages yang didukung oleh titik navigasi ini. Jika kosong, bukan berarti penggunaannya dibatasi dengan cara apa pun. Semua titik navigasi dapat digunakan untuk navigasi umum.
street_view_thumbnail

StreetViewThumbnail

Gambar thumbnail Street View yang menampilkan titik navigasi, jika tersedia. Gambar dapat diminta dari Street View Static API. Lihat https://developers.google.com/maps/documentation/streetview/request-streetview.
entrance_annotation

ImageAnnotation

Anotasi pintu masuk yang terkait dengan titik navigasi ini pada street_view_thumbnail yang ditampilkan di atas, jika tersedia.
altitude_meters

float

Ketinggian titik navigasi dalam meter relatif terhadap elipsoid WGS-84.

TravelMode

Mode perjalanan yang sesuai untuk titik navigasi ini.

Enum
TRAVEL_MODE_UNSPECIFIED Tidak digunakan.
DRIVE Cocok untuk mengemudi.
WALK Cocok untuk berjalan kaki.

Penggunaan

Penggunaan yang didukung oleh titik navigasi ini. Nilai baru mungkin akan ditambahkan pada masa mendatang.

Enum
USAGE_UNSPECIFIED Tidak digunakan.
UNKNOWN Menunjukkan bahwa jenis penggunaan tidak diketahui.
DROPOFF Cocok untuk menurunkan penumpang. Misalnya, lokasi penurunan penumpang transportasi online.
PICKUP Cocok untuk menjemput penumpang. Misalnya, lokasi penjemputan transportasi online.
PARKING Cocok untuk parkir. Misalnya, di dalam tempat parkir.

PlaceView

Merepresentasikan tampilan Tempat di Places API. Fitur ini juga memberikan informasi tambahan khusus untuk tujuan, seperti jenis struktur dan poligon tampilan.

Dalam beberapa kasus, PlaceView dengan ID tempat yang sama mungkin berbeda dari yang ditampilkan oleh Places API untuk kolom types dan display_name.

Kolom
place

string

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

string

ID unik tempat.
display_name

LocalizedText

Deskripsi tempat yang dapat dibaca manusia. Misalnya, "Gerbang B", "McDonalds"
primary_type

string

Jenis tempat utama dari tempat ini. Lihat https://developers.google.com/maps/documentation/places/web-service/place-types untuk mengetahui daftar nilai yang mungkin.

Catatan: Kolom ini tidak selalu diisi. Bersiaplah untuk menggunakan kolom types dalam situasi tersebut.
types[]

string

Semua jenis tempat terkait dari tempat ini. Lihat https://developers.google.com/maps/documentation/places/web-service/place-types untuk mengetahui daftar nilai yang mungkin.
formatted_address

string

Alamat satu baris.
postal_address

PostalAddress

Alamat terstruktur.
structure_type

PlaceView.StructureType

Jenis struktur yang sesuai dengan tempat ini.
location

LatLng

Lokasi tempat ini. Untuk tempat dengan poligon tampilan, ini dapat merepresentasikan tempat yang baik untuk menempatkan penanda di peta.
display_polygon

Struct

Garis batas poligon tempat dalam format GeoJSON, menggunakan format RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.

Catatan: Format RFC 7946 mendukung MultiPolygon, sehingga satu objek display_polygon dapat mewakili beberapa poligon.
address_components[]

PlaceView.AddressComponent

Komponen berulang untuk setiap tingkat lokalitas.

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 mungkin memiliki nama panjang "Australia".
short_text

string

Nama tekstual yang disingkat untuk komponen alamat, jika tersedia. Misalnya, komponen alamat untuk negara Australia mungkin memiliki nama pendek "AU".
types[]

string

Array yang menunjukkan jenis komponen alamat.

Nilai ini diambil dari tabel Jenis alamat dan jenis komponen alamat yang digunakan oleh Places API: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types
language_code

string

Bahasa yang digunakan untuk memformat komponen ini, dalam notasi CLDR.

StructureType

Jenis struktur yang diwakili oleh tempat ini.

Enum
STRUCTURE_TYPE_UNSPECIFIED Tidak digunakan.
POINT Lokasi titik.
SECTION Subbagian bangunan.
BUILDING Bangunan.
GROUNDS Area luas yang biasanya berisi beberapa bangunan, seperti kampus universitas, kompleks apartemen, atau pusat perbelanjaan.

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 mewakili area 1/8000 x 1/8000 derajat (~14 x 14 meter).
compound_code

string

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

SearchDestinationsRequest

Pesan permintaan untuk DestinationService.SearchDestinations.

Kolom
travel_modes[]

NavigationPoint.TravelMode

Opsional. Mode perjalanan untuk memfilter titik navigasi. Hal ini memengaruhi kolom navigation_points yang ditampilkan dalam respons. Jika kosong, titik navigasi semua moda transportasi akan ditampilkan.
language_code

string

Opsional. Bahasa yang digunakan untuk menampilkan hasil.
region_code

string

Opsional. Kode wilayah. Kode wilayah, yang ditetapkan sebagai nilai dua karakter ccTLD ("domain level teratas"). Parameter ini memengaruhi hasil berdasarkan hukum yang berlaku. Parameter ini juga memengaruhi, tetapi tidak sepenuhnya membatasi, hasil dari layanan.

Kolom union primary_query. Membuat kueri untuk tujuan utama. Lokasi ini dapat berupa tempat, alamat yang ditentukan sepenuhnya, atau lokasi LatLng. Beberapa tempat dan alamat dengan informasi minimal tidak akan dapat dijadikan tujuan.

Tujuan dibuat berdasarkan kueri utama yang ditentukan.

Catatan: hanya tempat dan alamat yang dapat memiliki tujuan navigasi yang didukung. Misalnya, tempat yang mewakili rumah atau kompleks apartemen dapat digunakan sebagai kueri utama, tetapi tempat yang mewakili lokalitas atau wilayah administratif tidak dapat digunakan sebagai kueri utama. primary_query hanya dapat berupa salah satu dari hal berikut:
place

string

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

SearchDestinationsRequest.AddressQuery

Alamat.
location_query

SearchDestinationsRequest.LocationQuery

Lokasi presisi.

AddressQuery

Alamat yang ingin Anda telusuri. Tetapkan alamat sesuai dengan format yang digunakan oleh layanan pos nasional untuk negara yang bersangkutan.

Kolom
Kolom union kind. Kueri alamat. kind hanya dapat berupa salah satu dari berikut:
address

PostalAddress

Alamat dalam format alamat pos.
address_query

string

Alamat jalan yang diformat sebagai satu baris.

LocationQuery

Kueri lokasi untuk mengidentifikasi tujuan utama di sekitar.

Catatan: jika kueri lokasi berada di dalam bangunan yang berisi sub-premis, kemungkinan tempat utama yang ditampilkan adalah sub-premis. Dalam kasus ini, kolom containing_places akan menyertakan bangunan.

Kolom
place_filter

SearchDestinationsRequest.LocationQuery.PlaceFilter

Opsional. Filter yang akan diterapkan ke kandidat tujuan.
Kolom union kind. Kueri lokasi. kind hanya dapat berupa salah satu dari berikut:
location

LatLng

Lokasi LatLng yang akurat.

PlaceFilter

Filter yang akan diterapkan ke kandidat tujuan.

Kolom
structure_type

PlaceView.StructureType

Opsional. Jika ditentukan, semua tujuan dijamin memiliki tempat utama dengan jenis struktur ini. Hal ini dapat mengakibatkan pemfilteran beberapa tujuan, atau memperluas/mempersempit tujuan yang ditampilkan.

Misalnya, jika GROUNDS ditentukan, semua tujuan yang ditampilkan akan memiliki tempat utama dengan jenis struktur GROUNDS. Hal ini dapat mengakibatkan pemfilteran beberapa tujuan yang bukan bagian dari area, atau dalam memperluas tujuan yang ditampilkan ke tingkat area.

Penggunaan lain dari kolom ini adalah untuk mengekstrak poligon tampilan bangunan dengan lebih mudah. Misalnya, jika BUILDING ditentukan, poligon tampilan tempat utama akan ditujukan untuk bangunan di lokasi yang ditentukan.
addressability

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

Opsional. Jika ditentukan, hanya menampilkan tujuan yang memenuhi kriteria kemampuan alamat yang sesuai.

Kemampuan respons

Menentukan opsi untuk pemfilteran kemampuan alamat. Nilai baru mungkin akan ditambahkan pada masa mendatang.

Enum
ADDRESSABILITY_UNSPECIFIED Jika tidak ditentukan, layanan akan memilih default yang sesuai.
ANY Kemampuan untuk dijangkau bukanlah kriteria pemfilteran. Tujuan ditampilkan terlepas dari apakah tujuan tersebut dapat dijangkau atau tidak.
PRIMARY Semua tujuan yang ditampilkan akan memiliki tempat utama dengan alamat atau nama tingkat jalan.
WEAK Semua tujuan yang ditampilkan akan memiliki tempat utama atau subtujuan dengan alamat atau nama tingkat jalan.

SearchDestinationsResponse

Pesan respons untuk DestinationService.SearchDestinations.

Kolom
destinations[]

Destination

Daftar tujuan.

Layanan akan menampilkan satu hasil jika tujuan utama dapat diidentifikasi secara jelas dari kueri utama. Jika tidak, layanan mungkin menampilkan beberapa hasil untuk disambiguasi atau tidak menampilkan hasil sama sekali.

StreetViewThumbnail

Parameter untuk merepresentasikan thumbnail Google Street View. Parameter ini dapat digunakan untuk meminta gambar Street View dari Street View Static API. Lihat https://developers.google.com/maps/documentation/streetview/request-streetview.

Kolom
pano

string

ID panorama tertentu.
width_px

int32

Lebar gambar thumbnail output dalam piksel. Catatan: Saat meminta anotasi bersama thumbnail, nilai tinggi dan lebar ini harus digunakan dalam permintaan API Street View untuk memastikan koordinat anotasi sejajar dengan benar dengan gambar.
height_px

int32

Tinggi gambar thumbnail output dalam piksel. Catatan: Saat meminta anotasi bersama thumbnail, nilai tinggi dan lebar ini harus digunakan dalam permintaan API Street View untuk memastikan koordinat anotasi sejajar dengan benar dengan gambar.
heading_degree

float

Orientasi horizontal kamera dalam derajat. Rentang [0, 360). 0 menunjukkan Utara dan 90 menunjukkan Timur.
pitch_degree

float

Orientasi vertikal kamera dalam derajat. Rentang [-90, 90]. 0 adalah horizon, +90 adalah lurus ke atas, -90 adalah lurus ke bawah.
fov_degree

float

Ruang Pandang Horizontal dalam derajat. Rentang (0, 180]. Mengontrol tingkat zoom. FOV yang lebih kecil berarti zoom yang lebih besar.