Geocoder

Class Geocoder

Class google.maps.Geocoder

Layanan untuk mengonversi alamat dan LatLng.

Saat menggunakan v=beta, dapat diakses dengan memanggil const {Geocoder} = await google.map.importLibrary("geocoding"). Lihat Library di Maps JavaScript API.
Geocoder
Geocoder()
Parameter: Tidak ada
Membuat instance Geocoder baru 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 optional
Jenis: string optional
Alamat untuk melakukan geocoding. Satu, dan hanya satu, dari address, location, dan placeId yang harus disediakan.
bounds optional
LatLngBounds yang akan digunakan untuk menelusuri. Opsional.
componentRestrictions optional
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.
language optional
Jenis: string optional
ID bahasa untuk bahasa tempat hasil harus ditampilkan, jika memungkinkan. Lihat daftar bahasa yang didukung.
location optional
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 disediakan.
placeId optional
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 dalam 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 disediakan.
region optional
Jenis: string optional
Kode negara yang digunakan untuk membiaskan penelusuran, ditetapkan sebagai subtag wilayah Unicode dua karakter (non-numerik)/ID CLDR. Opsional. Lihat Detail Cakupan Google Maps Platform untuk wilayah yang didukung.

Antarmuka GeocoderComponentRestrictions

Antarmuka google.maps.GeocoderComponentRestrictions

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

Konstanta GeocoderStatus

Konstanta google.maps.GeocoderStatus

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

Saat menggunakan v=beta, dapat diakses dengan memanggil const {GeocoderStatus} = await google.map.importLibrary("geocoding"). Lihat Library di Maps JavaScript API.
ERROR Ada masalah saat menghubungi server Google.
INVALID_REQUEST GeocoderRequest ini tidak valid.
OK Responsnya berisi GeocoderResponse yang valid.
OVER_QUERY_LIMIT Halaman web telah melebihi batas permintaan dalam jangka waktu yang terlalu singkat.
REQUEST_DENIED Halaman web tidak diizinkan menggunakan geocoder.
UNKNOWN_ERROR Permintaan geocoding tidak dapat diproses karena terjadi error server. Permintaan mungkin berhasil jika Anda mencoba lagi.
ZERO_RESULTS Tidak ada hasil yang ditemukan untuk GeocoderRequest ini.

Antarmuka GeocoderResponse

Antarmuka google.maps.GeocoderResponse

Respons Geocoder yang ditampilkan oleh Geocoder yang berisi daftar GeocoderResult.
results
Daftar GeocoderResult.

Antarmuka GeocoderResult

Antarmuka google.maps.GeocoderResult

Hasil geocoder tunggal yang diambil dari server geocode. Permintaan geocode mungkin mengembalikan beberapa objek hasil. Perhatikan bahwa meskipun hasil ini "seperti JSON", hasil ini tidak sepenuhnya JSON, karena secara tidak langsung menyertakan objek LatLng.
address_components
Array GeocoderAddressComponent
formatted_address
Jenis: string
String yang berisi alamat lokasi ini yang dapat dibaca orang.
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 ID Tempat lebih lanjut dalam panduan developer Places API.
types
Jenis: Array<string>
Array string yang menunjukkan jenis elemen geocode yang dikembalikan. Untuk daftar kemungkinan string, lihat bagian Jenis Komponen Alamat di Panduan Developer.
partial_match optional
Jenis: boolean optional
Apakah geocoder tidak mengembalikan hasil yang benar-benar cocok untuk permintaan asli, meskipun geocoder bisa mencocokkan sebagian dari alamat yang diminta. Jika pencocokan persis, nilainya adalah undefined.
plus_code optional
Jenis: PlacePlusCode optional
Plus Codes yang terkait dengan lokasi.
postcode_localities optional
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 GeocoderAddressComponent

Antarmuka google.maps.GeocoderAddressComponent

Komponen alamat tunggal 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 garis lintang/bujur dari hasil ini
location_type
Jenis lokasi yang ditampilkan di location
viewport
Batas area pandang yang direkomendasikan untuk menampilkan GeocoderResult ini
bounds optional
Jenis: LatLngBounds optional
Batas yang tepat dari GeocoderResult ini, jika berlaku

Konstanta GeocoderLocationType

Konstanta google.maps.GeocoderLocationType

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

Saat menggunakan v=beta, dapat diakses dengan memanggil const {GeocoderLocationType} = await google.map.importLibrary("geocoding"). Lihat Library di Maps JavaScript API.
APPROXIMATE Hasil yang ditampilkan adalah perkiraan.
GEOMETRIC_CENTER Hasil yang dikembalikan adalah pusat geometris dari hasil seperti garis (misalnya jalan) atau poligon (wilayah).
RANGE_INTERPOLATED Hasil yang dikembalikan mencerminkan perkiraan (biasanya di jalan) interpolasi antara dua titik tepat (seperti persimpangan). Hasil interpolasi umumnya dikembalikan bila rooftop-geocode tidak tersedia untuk alamat jalan.
ROOFTOP Hasil yang dikembalikan mencerminkan geocode akurat.