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 cocok untuk kasus penggunaan seperti layanan 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

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 presisi yang berisi tempat utama. Misalnya, kompleks apartemen yang berisi gedung ini.
sub_destinations[]

PlaceView

Sub-tujuan yang lebih presisi dari tempat utama. Misalnya, unit yang ada di dalam gedung.

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 saat tiba.
entrances[]

Entrance

Pintu masuk untuk tujuan ini.
navigation_points[]

NavigationPoint

Titik navigasi untuk tujuan ini.

Pintu Masuk

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

Kolom
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}.

Tag

Karakteristik yang menggambarkan pintu masuk.

Enum
TAG_UNSPECIFIED Tidak digunakan.
PREFERRED

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

Misalnya, jika tempat utama adalah restoran di pusat perbelanjaan, pintu masuk "UTAMA" 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 pusat perbelanjaan.

Jika tempat utama adalah bangunan itu sendiri, pintu masuk PREFERRED adalah 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 memberikan akses ke toko di samping gedung, pintu masuk tersebut tidak akan menjadi pintu masuk PREFERRED.

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

Tempat terkenal

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

Kolom
tags[]

Landmark.Tag

Tag yang menjelaskan cara penggunaan landmark dalam konteks tujuan.
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 penggunaan landmark dalam konteks tujuan.

Jika alamat memiliki tag ADDRESS dan ARRIVAL, artinya bangunan terkenal tersebut terlihat jelas di lokasi dan dekat dengan tujuan.

Enum
TAG_UNSPECIFIED Tidak digunakan.
ADDRESS Tempat yang terkenal di lokasi yang dapat digunakan untuk mengidentifikasi lokasi umum tujuan. Biasanya dalam jarak beberapa ratus meter dari tujuan. Hal ini serupa dengan landmark yang ditampilkan oleh fitur Deskriptor 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 berada di seberang jalan dari tujuan. Tempat penting dengan tag ini biasanya lebih dekat dengan tujuan daripada tempat penting dengan tag ADDRESS.

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

Kolom
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 bergeser 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

Penggunaan yang didukung oleh titik navigasi ini.

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.

Enum
USAGE_UNSPECIFIED Tidak digunakan.
UNKNOWN Jenis penggunaan tidak diketahui. Sebagian besar titik navigasi akan berupa UNKNOWN dan tidak berarti penggunaannya dibatasi dengan cara apa pun. Rute ini mungkin masih cocok untuk penjemputan dan/atau pengantaran.
DROPOFF Cocok untuk menurunkan penumpang. Misalnya, lokasi tujuan layanan transportasi online.
PICKUP Cocok untuk menjemput penumpang. Misalnya, lokasi penjemputan transportasi online.

PlaceView

Merepresentasikan tampilan Place di Places API. Kasus penggunaan 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 dengan yang ditampilkan oleh Places API untuk kolom types dan display_name.

Kolom
place

string

Nama resource tempat ini, dalam format places/{placeId}.
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 kemungkinan nilai.

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 kemungkinan nilai.
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 merepresentasikan beberapa poligon.

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 mal perbelanjaan.

SearchDestinationsRequest

Pesan permintaan untuk DestinationService.SearchDestinations.

Kolom
travel_modes[]

NavigationPoint.TravelMode

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

string

Opsional. Bahasa yang digunakan untuk menampilkan hasil.
region_code

string

Opsional. Kode wilayah. Kode wilayah, yang ditentukan 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. Kueri untuk tujuan utama. Ini dapat berupa tempat, alamat yang ditentukan sepenuhnya, atau lokasi LatLng. Beberapa tempat dan alamat dengan informasi minimal tidak dapat diubah menjadi tujuan.

Tujuan dibuat di sekitar kueri utama yang ditentukan.

Catatan: hanya tempat dan alamat yang dapat memiliki tujuan navigasi yang didukung. Misalnya, tempat yang merepresentasikan rumah atau kompleks apartemen dapat digunakan sebagai kueri utama, tetapi tempat yang merepresentasikan lokalitas atau area 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 jalan 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 jalan dalam format alamat pos.
address_query

string

Alamat jalan yang diformat sebagai satu baris.

LocationQuery

Kueri lokasi untuk mengidentifikasi tujuan utama terdekat.

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

Kolom
Kolom union kind. Kueri lokasi. kind hanya dapat berupa salah satu dari berikut:
location

LatLng

Lokasi LatLng presisi.

SearchDestinationsResponse

Pesan respons untuk DestinationService.SearchDestinations.

Kolom
destinations[]

Destination

Daftar tujuan.

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