Geocoder sınıfı
google.maps.Geocoder
sınıf
Adres ile LatLng
arasında dönüşüm sağlayan bir hizmet.
const {Geocoder} = await google.maps.importLibrary("geocoding")
numaralı telefonu arayarak erişebilirsiniz. Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
Marka | |
---|---|
Geocoder |
Geocoder() Parametreler: Yok
Google sunucularına coğrafi kod istekleri gönderen yeni bir Geocoder örneği oluşturur. |
Yöntemler | |
---|---|
geocode |
geocode(request[, callback]) Parametreler:
Döndürülen Değer:
Promise<GeocoderResponse> Bir isteği coğrafi kodlayın. |
GeocoderRequest arayüzü
google.maps.GeocoderRequest
arayüz
Geocoder
adresine gönderilecek bir coğrafi kodlama isteği için spesifikasyon.
Özellikler | |
---|---|
address optional |
Tür:
string optional Coğrafi kodlanacak adres. address , location ve placeId özelliklerinden yalnızca biri sağlanmalıdır. |
bounds optional |
Tür:
LatLngBounds|LatLngBoundsLiteral optional LatLngBounds içinde arama yapılır. İsteğe bağlı. |
componentRestrictions optional |
Tür:
GeocoderComponentRestrictions optional Bileşenler, sonuçları belirli bir alanla sınırlamak için kullanılır. Filtreler şu değerlerden en az birini 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şleme yöntemlerini destekler. İsteğe bağlı. |
language optional |
Tür:
string optional Mümkün olduğunda sonuçların döndürülmesi gereken dil için dil tanımlayıcısı. Desteklenen dillerin listesine bakın. |
location optional |
Tür:
LatLng|LatLngLiteral optional Arama yapılacak LatLng (veya LatLngLiteral ). Coğrafi kodlayıcı, tersine coğrafi kodlama işlemi gerçekleştirir. Daha fazla bilgi için Geri 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şkili yer kimliği. Yer kimlikleri, Google Rehber veritabanında ve Google Haritalar'da bir yeri benzersiz şekilde tanımlar. Places API geliştirici kılavuzunda yer kimlikleri hakkında daha fazla bilgi edinin. Coğrafi kodlayıcı, tersine coğrafi kodlama işlemi gerçekleştirir. Daha fazla bilgi için Geri Coğrafi Kodlama bölümüne bakın. address , location ve placeId özelliklerinden yalnızca biri sağlanmalıdır. |
region optional |
Tür:
string optional Aramaya önyargı katmak için kullanılan ülke kodu. İki karakterli (sayısal olmayan) Unicode bölge alt etiketi / CLDR tanımlayıcısı olarak belirtilir. İsteğe bağlı. Desteklenen bölgeler için Google Haritalar Platformu Kapsam Ayrıntıları'na bakın. |
GeocoderComponentRestrictions arayüzü
google.maps.GeocoderComponentRestrictions
arayüz
GeocoderComponentRestrictions
, belirli bir alana yönlendiren bir filtre grubunu temsil eder. Bunun işleyiş şekliyle ilgili ayrıntılar için Coğrafi Kodlama Bileşeni Filtrelemesi başlıklı makaleyi inceleyin.
Ö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ıyla 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şir. İsteğe bağlı. |
route optional |
Tür:
string optional Bir route 'ün uzun veya kısa adıyla eşleşir. İsteğe bağlı. |
GeocoderStatus constants
google.maps.GeocoderStatus
constants
geocode()
'a yapılan bir aramanın tamamlanması üzerine Geocoder
tarafından döndürülen durum. Bunları değere göre veya sabitin adını kullanarak belirtin. Örneğin, 'OK'
veya google.maps.GeocoderStatus.OK
.
const {GeocoderStatus} = await google.maps.importLibrary("geocoding")
numaralı telefonu arayarak erişebilirsiniz. Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
Sabitler | |
---|---|
ERROR |
Google sunucularıyla bağlantı kurulurken sorun oluştu. |
INVALID_REQUEST |
Bu GeocoderRequest geçersizdi. |
OK |
Yanıtta geçerli bir GeocoderResponse var. |
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ıyı kullanmasına izin verilmiyor. |
UNKNOWN_ERROR |
Coğrafi kodlama isteği, sunucu hatası nedeniyle 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
Geocoder
tarafından döndürülen ve GeocoderResult
'ların listesini içeren bir Coğrafi Kodlayıcı yanıtı.
Özellikler | |
---|---|
results |
Tür:
Array<GeocoderResult> GeocoderResult değerlerinin listesi. |
GeocoderResult sınıfı
google.maps.GeocoderResult
arayüz
Coğrafi kodlama sunucusundan alınan tek bir coğrafi kodlayıcı sonucu. Coğrafi kodlama isteği birden fazla sonuç nesnesi döndürebilir. Bu sonucun "JSON benzeri" olmasına rağmen dolaylı olarak bir LatLng
nesnesi içerdiği için tam olarak JSON olmadığını unutmayın.
Özellikler | |
---|---|
address_components |
GeocoderAddressComponent dizisi |
formatted_address |
Tür:
string Bu konumun kullanıcıların okuyabileceği adresini içeren bir dize. |
geometry |
Tür:
GeocoderGeometry GeocoderGeometry nesnesi |
place_id |
Tür:
string Konumla ilişkili yer kimliği. Yer kimlikleri, Google Rehber veritabanında ve Google Haritalar'da bir yeri benzersiz ş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 kodlanmış öğ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 Coğrafi kodlayıcı, istenen adresin bir kısmını eşleştirebilmesine rağmen orijinal istek için tam eşleşme döndürmediyse. Tam eşleşme varsa değer undefined olur. |
plus_code optional |
Tür:
PlacePlusCode optional Konumla ilişkili Plus Code. |
postcode_localities optional |
Tür:
Array<string> optional Bir posta kodunda bulunan tüm yerellikleri belirten bir dize dizisi. Bu, yalnızca sonuç birden fazla yerleşim yeri içeren bir posta kodu olduğunda gösterilir. |
GeocoderAddressComponent arayüzü
google.maps.GeocoderAddressComponent
arayüz
GeocoderResult
içinde 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 listesini burada bulabilirsiniz. |
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 parametresinde döndürülen konum türü |
viewport |
Tür:
LatLngBounds Bu GeocoderResult için görüntü alanının önerilen sınırları |
bounds optional |
Tür:
LatLngBounds optional Varsa bu GeocoderResult öğesinin tam sınırları |
GeocoderLocationType sabitleri
google.maps.GeocoderLocationType
constants
Coğrafi koddan döndürülen konum türünü açıklar. Bunları değere göre veya sabitin adını kullanarak belirtin. Örneğin, 'ROOFTOP'
veya google.maps.GeocoderLocationType.ROOFTOP
.
const {GeocoderLocationType} = await google.maps.importLibrary("geocoding")
numaralı telefonu arayarak erişebilirsiniz. Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
Sabitler | |
---|---|
APPROXIMATE |
Döndürülen sonuç yaklaşıktır. |
GEOMETRIC_CENTER |
Döndürülen sonuç, çizgi (ör. sokak) veya poligon (bölge) gibi bir sonucun geometrik merkezidir. |
RANGE_INTERPOLATED |
Döndürülen sonuç, iki kesin nokta (ör. kavşaklar) arasında interpolasyon uygulanmış bir yaklaşık değeri (genellikle bir yolda) yansıtır. Düzenlenmiş sonuçlar genellikle bir sokak adresi için çatı jeokodları kullanılamadığında döndürülür. |
ROOFTOP |
Döndürülen sonuç, hassas bir coğrafi kodu yansıtır. |