Geocoder

Class Geocoder

google.maps.Geocoder class
library "geocoding"

Layanan untuk mengonversi antara alamat dan LatLng.

const {Geocoder} = await google.maps.importLibrary("geocoding");
Geocoder
Geocoder()
Parameter: Tidak ada
Membuat instance baru Geocoder yang mengirim permintaan geocode ke server Google.
geocode
geocode(request[, callback])
Parameter:
Nilai Hasil: Promise<GeocoderResponse>
Memberi geocode pada permintaan.

Antarmuka GeocoderRequest

Antarmuka google.maps.GeocoderRequest

Spesifikasi untuk permintaan geocoding yang akan dikirim ke Geocoder.
address
opsional
Jenis: string optional
Alamat yang akan di-geocode. Satu, dan hanya satu, dari address, location, dan placeId yang harus diberikan.
bounds
opsional
LatLngBounds yang akan ditelusuri. Opsional.
componentRestrictions
opsional
Komponen digunakan untuk membatasi hasil ke area tertentu. Filter terdiri dari satu atau beberapa: route, locality, administrativeArea, postalCode, country. Hanya hasil yang cocok dengan semua filter yang akan dikembalikan. Nilai-nilai filter mendukung metode yang sama untuk koreksi ejaan dan kecocokan parsial seperti permintaan geocoding lainnya. Opsional.
BetaextraComputations
opsional
Daftar komputasi tambahan yang dapat digunakan untuk menyelesaikan permintaan. Catatan: Komputasi tambahan ini dapat menampilkan kolom tambahan pada respons.
fulfillOnZeroResults
opsional
Jenis: boolean optional
Penuhi promise pada status ZERO_RESULT dalam respons. Hal ini mungkin diinginkan karena meskipun tidak ada hasil geocoding, mungkin masih ada kolom tingkat respons tambahan yang ditampilkan.
language
opsional
Jenis: string optional
ID bahasa untuk bahasa yang akan digunakan untuk menampilkan hasil, jika memungkinkan. Lihat daftar bahasa yang didukung.
location
opsional
Jenis: LatLng|LatLngLiteral optional
LatLng (atau LatLngLiteral) yang akan ditelusuri. Geocoder akan melakukan geocoding terbalik. Lihat Geocoding Terbalik untuk informasi selengkapnya. Satu, dan hanya satu, dari address, location, dan placeId yang harus diberikan.
placeId
opsional
Jenis: string optional
ID tempat yang terkait dengan lokasi. ID tempat secara unik mengidentifikasi tempat di database Google Places dan Google Maps. Pelajari lebih lanjut ID tempat di panduan developer Places API. Geocoder akan melakukan geocoding terbalik. Lihat Geocoding Terbalik untuk informasi selengkapnya. Satu, dan hanya satu, dari address, location, dan placeId yang harus diberikan.
region
opsional
Jenis: string optional
Kode negara yang digunakan untuk membiaskan penelusuran, yang ditentukan sebagai subtag wilayah Unicode/ID CLDR dua karakter (non-numerik). Opsional. Lihat Detail Cakupan Google Maps Platform untuk mengetahui wilayah yang didukung.

Antarmuka GeocoderComponentRestrictions

Antarmuka google.maps.GeocoderComponentRestrictions

GeocoderComponentRestrictions mewakili kumpulan filter yang ditetapkan ke area tertentu. Untuk mengetahui detail tentang cara kerjanya, lihat Pemfilteran Komponen Geocoding.
administrativeArea
opsional
Jenis: string optional
Cocok dengan semua administrative_area levels. Opsional.
country
opsional
Jenis: string optional
Cocok dengan nama negara atau kode negara ISO 3166-1 dua huruf. Opsional.
locality
opsional
Jenis: string optional
Cocok dengan jenis locality dan sublocality. Opsional.
postalCode
opsional
Jenis: string optional
Cocok dengan postal_code dan postal_code_prefix. Opsional.
route
opsional
Jenis: string optional
Cocok dengan nama panjang atau nama pendek route. Opsional.

Konstanta ExtraGeocodeComputation

google.maps.ExtraGeocodeComputation konstanta library
"geocoding"

Komputasi tambahan yang akan dilakukan saat menyelesaikan permintaan geocoding.

Konstanta ini juga dapat digunakan sebagai string. Di TypeScript, literal string ditentukan oleh jenis ExtraGeocodeComputationString.

const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding");
ADDRESS_DESCRIPTORS Buat deskripsi alamat.

Konstanta GeocoderStatus

google.maps.GeocoderStatus konstanta library
"geocoding"

Status yang ditampilkan oleh Geocoder setelah panggilan ke geocode() selesai. Tentukan ini berdasarkan nilai, atau dengan menggunakan nama konstanta. Misalnya, 'OK' atau google.maps.GeocoderStatus.OK.

Konstanta ini juga dapat digunakan sebagai string. Di TypeScript, literal string ditentukan oleh jenis GeocoderStatusString.

const {GeocoderStatus} = await google.maps.importLibrary("geocoding");
ERROR Ada masalah saat menghubungi server Google.
INVALID_REQUEST GeocoderRequest ini tidak valid.
OK Respons berisi GeocoderResponse yang valid.
OVER_QUERY_LIMIT Halaman web telah melampaui batas permintaan dalam jangka waktu yang terlalu singkat.
REQUEST_DENIED Halaman web tidak diizinkan untuk menggunakan geocoder.
UNKNOWN_ERROR Permintaan geocoding tidak dapat diproses karena error server. Permintaan mungkin berhasil jika Anda mencoba lagi.
ZERO_RESULTS Tidak ditemukan hasil untuk GeocoderRequest ini.

Antarmuka GeocoderResponse

Antarmuka google.maps.GeocoderResponse

Respons Geocoder yang ditampilkan oleh Geocoder yang berisi daftar GeocoderResult.
results
Daftar GeocoderResult.
Betaaddress_descriptor
opsional
Jenis: AddressDescriptor optional
Deskripsi relasional suatu lokasi. Menyertakan kumpulan tempat terkenal di sekitar dan area yang berisi lokasi target, yang diberi peringkat. Kolom ini hanya diisi untuk permintaan geocoding terbalik dan hanya jika ExtraGeocodeComputation.ADDRESS_DESCRIPTORS diaktifkan.
plus_code
opsional
Jenis: PlacePlusCode optional
Plus Codes yang terkait dengan lokasi.

Antarmuka GeocoderResult

Antarmuka google.maps.GeocoderResult

Satu hasil geocoder yang diambil dari server geocode. Permintaan geocode mungkin menampilkan beberapa objek hasil. Perhatikan bahwa meskipun hasil ini "mirip JSON", hasil ini bukanlah JSON yang sebenarnya, karena secara tidak langsung menyertakan objek LatLng.
address_components
Array GeocoderAddressComponent
formatted_address
Jenis: string
String yang berisi alamat lokasi ini yang dapat dibaca manusia.
geometry
Objek GeocoderGeometry
place_id
Jenis: string
ID tempat yang terkait dengan lokasi. ID tempat secara unik mengidentifikasi tempat di database Google Places dan Google Maps. Pelajari lebih lanjut ID Tempat di panduan developer Places API.
types
Jenis: Array<string>
Array string yang menunjukkan jenis elemen yang di-geocode yang ditampilkan. Untuk mengetahui daftar string yang mungkin, lihat bagian Jenis Komponen Alamat dalam Panduan Developer.
Betaaddress_descriptor
opsional
Jenis: AddressDescriptor optional
Deskripsi relasional lokasi yang terkait dengan geocode ini. Menyertakan kumpulan tempat terkenal di sekitar dan area yang berisi lokasi target, yang diberi peringkat. Kolom ini hanya akan diisi untuk permintaan geocoding maju dan pencarian ID tempat, hanya jika ExtraGeocodeComputation.ADDRESS_DESCRIPTORS diaktifkan, dan hanya untuk tempat tertentu yang dilokalkan.
partial_match
opsional
Jenis: boolean optional
Apakah geocoder tidak menampilkan kecocokan persis untuk permintaan asli, meskipun jika geocoder dapat menampilkan kecocokan sebagian dengan alamat yang diminta. Jika cocok persis, nilainya akan menjadi undefined.
plus_code
opsional
Jenis: PlacePlusCode optional
Plus Codes yang terkait dengan lokasi.
postcode_localities
opsional
Jenis: Array<string> optional
Array string yang menunjukkan semua lokalitas yang dimuat dalam kode pos. Ini hanya ada bila hasilnya adalah kode pos yang berisi beberapa lokalitas.

Antarmuka AddressDescriptor

Antarmuka google.maps.AddressDescriptor

Deskripsi relasional suatu lokasi. Menyertakan kumpulan tempat terkenal di sekitar dan area yang berisi lokasi target, yang diberi peringkat.
areas
Jenis: Array<Area>
Daftar peringkat area yang berisi atau berdekatan. Area yang paling berguna (dapat dikenali dan akurat) diberi peringkat pertama.
landmarks
Jenis: Array<Landmark>
Daftar tempat terkenal di sekitar yang diberi peringkat. Penanda yang paling berguna (dapat dikenali dan berada di sekitar) akan diberi peringkat pertama.

Antarmuka GeocoderAddressComponent

Antarmuka google.maps.GeocoderAddressComponent

Satu komponen alamat dalam GeocoderResult. Alamat lengkap dapat terdiri dari beberapa komponen alamat.
long_name
Jenis: string
Teks lengkap komponen alamat
short_name
Jenis: string
Teks singkat yang disingkat dari komponen alamat yang diberikan
types
Jenis: Array<string>
Array string yang menunjukkan jenis komponen alamat ini. Daftar jenis yang valid dapat ditemukan di sini

Antarmuka GeocoderGeometry

Antarmuka google.maps.GeocoderGeometry

Informasi geometri tentang GeocoderResult ini
location
Jenis: LatLng
Koordinat lintang/bujur hasil ini
location_type
Jenis lokasi yang ditampilkan di location
viewport
Batas area pandang yang direkomendasikan untuk menampilkan GeocoderResult ini
bounds
opsional
Jenis: LatLngBounds optional
Batas akurat GeocoderResult ini, jika ada

Konstanta GeocoderLocationType

google.maps.GeocoderLocationType konstanta library
"geocoding"

Menjelaskan jenis lokasi yang ditampilkan dari geocode. Tentukan ini berdasarkan nilai, atau dengan menggunakan nama konstanta. Misalnya 'ROOFTOP' atau google.maps.GeocoderLocationType.ROOFTOP.

Konstanta ini juga dapat digunakan sebagai string. Di TypeScript, literal string ditentukan oleh jenis GeocoderLocationTypeString.

const {GeocoderLocationType} = await google.maps.importLibrary("geocoding");
APPROXIMATE Hasil yang ditampilkan adalah perkiraan.
GEOMETRIC_CENTER Hasil yang ditampilkan adalah pusat geometris dari hasil seperti garis (misalnya, jalan) atau poligon (wilayah).
RANGE_INTERPOLATED Hasil yang ditampilkan mencerminkan perkiraan (biasanya pada jalan) interpolasi antara dua titik tepat (seperti persimpangan). Hasil interpolasi umumnya dikembalikan bila rooftop-geocode tidak tersedia untuk alamat jalan.
ROOFTOP Hasil yang ditampilkan mencerminkan geocode yang akurat.

Antarmuka Landmark

Antarmuka google.maps.Landmark

Tempat yang mewakili titik acuan untuk alamat.
display_name
Jenis: string
Nama tempat terkenal.
display_name_language_code
Jenis: string
Bahasa nama tempat terkenal.
place_id
Jenis: string
ID Tempat dari bangunan pokok yang berfungsi sebagai tempat terkenal. Dapat digunakan untuk mendapatkan informasi selengkapnya tentang tempat terkenal melalui Place Details atau ID Tempat Lookup.
spatial_relationship
Menentukan hubungan spasial antara lokasi target dan tempat terkenal.
straight_line_distance_meters
Jenis: number
Jarak garis lurus antara lokasi target dan tempat terkenal.
types
Jenis: Array<string>
Satu atau beberapa nilai yang menunjukkan jenis hasil yang ditampilkan. Lihat Jenis untuk mengetahui detail selengkapnya.
travel_distance_meters
opsional
Jenis: number optional
Jarak perjalanan di sepanjang jaringan jalan antara lokasi target dan tempat terkenal. Kolom ini dapat tidak diisi jika tempat terkenal tidak terhubung ke bagian jaringan jalan yang paling dekat dengan target ATAU jika lokasi target sebenarnya tidak dianggap berada di jaringan jalan.

Antarmuka Area

Antarmuka google.maps.Area

Tempat yang merupakan wilayah kecil, seperti lingkungan, sublokalitas, atau kompleks besar yang berisi lokasi target.
containment
Menentukan hubungan spasial antara lokasi target dan area.
display_name
Jenis: string
Nama area.
display_name_language_code
Jenis: string
Bahasa nama untuk area tersebut.
place_id
Jenis: string
ID Tempat dari area yang mendasarinya. Dapat digunakan untuk mendapatkan informasi selengkapnya tentang area tersebut melalui Place Details atau ID Tempat.

Konstanta pembatasan

google.maps.Containment konstanta library
"geocoding"

Enum yang mewakili hubungan spasial antara area dan lokasi target.

Konstanta ini juga dapat digunakan sebagai string. Di TypeScript, literal string ditentukan oleh jenis ContainmentString.

const {Containment} = await google.maps.importLibrary("geocoding");
NEAR Lokasi target berada di luar wilayah area, tetapi dekat.
OUTSKIRTS Lokasi target berada di dalam wilayah area, dekat dengan tepi.
WITHIN Lokasi target berada di dalam wilayah area, dekat dengan pusat.

Konstanta SpatialRelationship

google.maps.SpatialRelationship konstanta library
"geocoding"

Enum yang merepresentasikan hubungan dalam ruang antara tempat terkenal dan target.

Konstanta ini juga dapat digunakan sebagai string. Di TypeScript, literal string ditentukan oleh jenis SpatialRelationshipString.

const {SpatialRelationship} = await google.maps.importLibrary("geocoding");
ACROSS_THE_ROAD Target berada tepat di seberang tempat terkenal di sisi lain jalan.
AROUND_THE_CORNER Tidak berada di rute yang sama dengan tempat terkenal, tetapi hanya berjarak satu belokan.
BEHIND Dekat dengan struktur tempat terkenal, tetapi lebih jauh dari titik aksesnya.
BESIDE Target berada tepat di samping tempat terkenal.
DOWN_THE_ROAD Di rute yang sama dengan tempat terkenal, tetapi tidak di samping atau di seberangnya.
NEAR Ini adalah hubungan default jika tidak ada hal yang lebih spesifik di bawah yang berlaku.
WITHIN Penanda memiliki geometri spasial dan target berada dalam batasnya.