Geocoder sınıf
google.maps.Geocoder
sınıf
Adres ve LatLng
arasında dönüşüm sağlayan bir hizmet.
const {Geocoder} = await google.maps.importLibrary("geocoding")
numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki Kitaplıklar konusuna bakın.
Marka | |
---|---|
Geocoder |
Geocoder() Parametreler: Yok
Google sunucularına coğrafi kodlama istekleri gönderen yeni bir Geocoder örneği oluşturur. |
Yöntemler | |
---|---|
geocode |
geocode(request[, callback]) Parametreler:
Dönüş Değeri:
Promise<GeocoderResponse> Bir isteğe coğrafi kodlayın. |
GeocoderRequest arayüzü
google.maps.GeocoderRequest
arayüz
Geocoder
'a gönderilecek bir coğrafi kodlama isteği spesifikasyonu.
Özellikler | |
---|---|
address optional |
Tür:
string optional Coğrafi kodlama adresi. address , location ve placeId özelliklerinden yalnızca biri sağlanmalıdır. |
bounds optional |
Tür:
LatLngBounds|LatLngBoundsLiteral optional İçinde arama yapılacağı LatLngBounds . İsteğe bağlı. |
componentRestrictions optional |
Tür:
GeocoderComponentRestrictions optional Bileşenler, sonuçları belirli bir alanla kısıtlamak için kullanılır. Filtre şunlardan biri veya daha fazlasını içerir: route , locality , administrativeArea , postalCode , country . Yalnızca tüm filtrelerle eşleşen sonuçlar döndürülür. Filtre değerleri, diğer coğrafi kodlama istekleriyle aynı yazım düzeltme ve kısmi eşleşme yöntemlerini destekler. İsteğe bağlı. |
language optional |
Tür:
string optional Mümkün olduğunda sonuçların döndürüleceği dil için dil tanımlayıcısı. Desteklenen dillerin listesine bakın. |
location optional |
Tür:
LatLng|LatLngLiteral optional Aranacak LatLng (veya LatLngLiteral ). Coğrafi kodlayıcı, ters coğrafi kodlama gerçekleştirir. Daha fazla bilgi için Ters Coğrafi Kodlama başlıklı makaleyi inceleyin. address , location ve placeId özelliklerinden yalnızca biri sağlanmalıdır. |
placeId optional |
Tür:
string optional Konumla ilişkilendirilen yer kimliği. Yer kimlikleri, Google Rehber veritabanında ve Google Haritalar'da bir yeri benzersiz bir şekilde tanımlar. Places API geliştirici kılavuzunda yer kimlikleri hakkında daha fazla bilgi edinin. Coğrafi kodlayıcı, ters coğrafi kodlama gerçekleştirir. Daha fazla bilgi için Ters Coğrafi Kodlama başlıklı makaleyi inceleyin. address , location ve placeId özelliklerinden yalnızca biri sağlanmalıdır. |
region optional |
Tür:
string optional Aramayı ağırlıklandırmak için kullanılan, iki karakterli (sayısal olmayan) bir Unicode bölge alt etiketi / CLDR tanımlayıcısı olarak belirtilen ülke kodu. İsteğe bağlı. Desteklenen bölgeler için Google Haritalar Platformu Kapsam Ayrıntıları bölümüne bakın. |
GeocoderComponentRestrictions arayüzü
google.maps.GeocoderComponentRestrictions
arayüz
GeocoderComponentRestrictions
, belirli bir alana çözümlenen bir filtre grubunu temsil eder. Bunun işleyiş şekliyle ilgili ayrıntılar için Coğrafi Kodlama Bileşeni Filtreleme bölümüne bakın.
Özellikler | |
---|---|
administrativeArea optional |
Tür:
string optional Tüm administrative_area levels ile eşleşir. İsteğe bağlı. |
country optional |
Tür:
string optional Bir ülke adı veya iki harfli ISO 3166-1 ülke koduyla eşleşir. İsteğe bağlı. |
locality optional |
Tür:
string optional Hem locality hem de sublocality türleriyle eşleşir. İsteğe bağlı. |
postalCode optional |
Tür:
string optional postal_code ve postal_code_prefix ile eşleşiyor. İsteğe bağlı. |
route optional |
Tür:
string optional Bir route öğesinin uzun veya kısa adıyla eşleşir. İsteğe bağlı. |
GeocoderStatus sabitleri
google.maps.GeocoderStatus
sabit değer
geocode()
numarasına yapılan aramanın tamamlanmasında Geocoder
tarafından döndürülen durum. Bunları değere göre veya sabit değerin adını kullanarak belirtin. Örneğin, 'OK'
veya google.maps.GeocoderStatus.OK
.
const {GeocoderStatus} = await google.maps.importLibrary("geocoding")
numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki Kitaplıklar konusuna bakın.
Sabitler | |
---|---|
ERROR |
Google sunucularıyla bağlantı kurulurken bir sorun oluştu. |
INVALID_REQUEST |
Bu GeocoderRequest geçersizdi. |
OK |
Yanıt geçerli bir GeocoderResponse içeriyor. |
OVER_QUERY_LIMIT |
Web sayfası, çok kısa bir süre içinde istek sınırını aştı. |
REQUEST_DENIED |
Web sayfasının coğrafi kodlayıcı kullanmasına izin verilmiyor. |
UNKNOWN_ERROR |
Sunucu hatası nedeniyle coğrafi kodlama isteği işlenemedi. Tekrar denerseniz istek başarılı olabilir. |
ZERO_RESULTS |
Bu GeocoderRequest için sonuç bulunamadı. |
GeocoderResponse arayüzü
google.maps.GeocoderResponse
arayüz
GeocoderResult
listesini içeren Geocoder
tarafından döndürülen coğrafi kodlayıcı yanıtı.
Özellikler | |
---|---|
results |
Tür:
Array<GeocoderResult> GeocoderResult listesi. |
GeocoderResult arayüzü
google.maps.GeocoderResult
arayüz
Coğrafi kod sunucusundan alınan tek bir coğrafi kodlayıcı sonucu. Coğrafi kodlama isteği, birden çok sonuç nesnesi döndürebilir. Bu sonuç "JSON benzeri" olsa da dolaylı olarak bir LatLng
nesnesi içerdiğinden tam olarak JSON olmadığını unutmayın.
Özellikler | |
---|---|
address_components |
GeocoderAddressComponent dizisi |
formatted_address |
Tür:
string Bu konumun kullanıcılar tarafından okunabilen adresini içeren bir dize. |
geometry |
Tür:
GeocoderGeometry GeocoderGeometry nesnesi |
place_id |
Tür:
string Konumla ilişkilendirilen yer kimliği. Yer kimlikleri, Google Rehber veritabanında ve Google Haritalar'da bir yeri benzersiz bir şekilde tanımlar. Places API geliştirici kılavuzunda Yer Kimlikleri hakkında daha fazla bilgi edinin. |
types |
Tür:
Array<string> Döndürülen coğrafi kodlu öğenin türünü belirten bir dize dizisi. Olası dizelerin listesi için Geliştirici Kılavuzu'nun Adres Bileşeni Türleri bölümüne bakın. |
partial_match optional |
Tür:
boolean optional İstenen adresin bir kısmını eşleştirebildiği halde, coğrafi kodlayıcının orijinal istek için tam eşleşme döndürüp döndürmediği. Tam eşleşme varsa değer undefined olur. |
plus_code optional |
Tür:
PlacePlusCode optional Konumla ilişkili artı kodu. |
postcode_localities optional |
Tür:
Array<string> optional Bir posta kodunda bulunan tüm şehirleri belirten bir dize dizisi. Bu hata yalnızca birden çok şehir içeren bir posta kodu sonucunun ortaya çıkması durumunda mevcuttur. |
GeocoderAddressComponent arayüzü
google.maps.GeocoderAddressComponent
arayüz
GeocoderResult
içindeki tek bir adres bileşeni. Tam adres, birden fazla adres bileşeninden oluşabilir.
Özellikler | |
---|---|
long_name |
Tür:
string Adres bileşeninin tam metni |
short_name |
Tür:
string Belirtilen adres bileşeninin kısaltılmış metni |
types |
Tür:
Array<string> Bu adres bileşeninin türünü belirten bir dize dizisi. Geçerli türlerin listesine buradan ulaşabilirsiniz. |
GeocoderGeometry arayüzü
google.maps.GeocoderGeometry
arayüz
Bu GeocoderResult
ile ilgili geometri bilgileri
Özellikler | |
---|---|
location |
Tür:
LatLng Bu sonucun enlem/boylam koordinatları |
location_type |
Tür:
GeocoderLocationType location içinde döndürülen konum türü |
viewport |
Tür:
LatLngBounds Bu GeocoderResult öğesini görüntülemek için önerilen görüntü alanının sınırları |
bounds optional |
Tür:
LatLngBounds optional Varsa bu GeocoderResult öğesinin tam sınırları |
GeocoderLocationType sabit değerleri
google.maps.GeocoderLocationType
sabit değer
Bir coğrafi koddan döndürülen konum türünü açıklar. Bunları değere göre veya sabit değerin adını kullanarak belirtin. Örneğin, 'ROOFTOP'
veya google.maps.GeocoderLocationType.ROOFTOP
.
const {GeocoderLocationType} = await google.maps.importLibrary("geocoding")
numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki Kitaplıklar konusuna bakın.
Sabitler | |
---|---|
APPROXIMATE |
Döndürülen sonuç yaklaşıktır. |
GEOMETRIC_CENTER |
Döndürülen sonuç, bir çizgi (ör. sokak) veya poligon (bölge) gibi bir sonucun geometrik merkezidir. |
RANGE_INTERPOLATED |
Döndürülen sonuç, iki kesin nokta (kavşaklar gibi) arasında ortalanmış bir yaklaşık (genellikle bir yol üzerinde) gösterir. İnterpolasyon sonuçları genellikle, bir sokak adresi için çatı coğrafi kodları kullanılamadığında döndürülür. |
ROOFTOP |
Döndürülen sonuç, kesin bir coğrafi kodu yansıtır. |