Geocoder sınıfı
google.maps.Geocoder
sınıf
Bir adres ile LatLng
arasında dönüşüm sağlayan bir hizmet.
v=beta
kullanılırken const {Geocoder} = await google.map.importLibrary("geocoding")
kullanılarak arama yapılabilir. Maps JavaScript API'deki 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:
İade Değeri:
Promise<GeocoderResponse> Bir isteğin coğrafi kodunu bildirin. |
GeocoderRequest arayüz
google.maps.GeocoderRequest
arayüz
Geocoder
adresine gönderilecek coğrafi kodlama isteğinin spesifikasyonu.
Özellikler | |
---|---|
address optional |
Tür:
string optional Coğrafi kodlama adresi. address , location ve placeId türlerinden 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 kısıtlamak için kullanılır. Bir filtre şunlardan biri veya daha fazlasını oluşturuyor: 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 dile ilişkin dil tanımlayıcısıdır. Desteklenen dillerin listesine bakın. |
location optional |
Tür:
LatLng|LatLngLiteral optional LatLng (veya LatLngLiteral ) için arama yapılacak. Kodlayıcı, coğrafi kodlamayı tersine çeviriyor. Daha fazla bilgi için Ters Coğrafi Kodlama başlıklı makaleye bakın. address , location ve placeId türlerinden yalnızca biri sağlanmalıdır. |
placeId optional |
Tür:
string optional Konumla ilişkili yer kimliği. Yer kimlikleri, bir yeri Google Yerler veritabanında ve Google Haritalar'da benzersiz bir şekilde tanımlar. Yerler API'si geliştirici kılavuzunda yer kimlikleri hakkında daha fazla bilgi edinebilirsiniz. Kodlayıcı, coğrafi kodlamayı tersine çeviriyor. Daha fazla bilgi için Ters Coğrafi Kodlama başlıklı makaleye bakın. address , location ve placeId türlerinden yalnızca biri sağlanmalıdır. |
region optional |
Tür:
string optional Aramaya ağırlık vermek için kullanılan, iki karakterlik (sayısal olmayan) bir Unicode bölge alt etiketi / CLDR tanımlayıcısı olan ülke kodu. İsteğe bağlı. Desteklenen bölgeler için Google Haritalar Platformu Kapsam Ayrıntıları konusuna bakın. |
GeocodercomponentRestrictions arayüz
google.maps.GeocoderComponentRestrictions
arayüz
GeocoderComponentRestrictions
, belirli bir alana çözümlenen filtre grubunu temsil eder. Bunun işleyiş şekliyle ilgili ayrıntılar için Coğrafi Kodlama Bileşeni Filtreleme 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ı 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ürüyle 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 öğesinin uzun veya kısa adıyla eşleşir. İsteğe bağlı. |
GeocoderStatus sabit değerleri
google.maps.GeocoderStatus
sabit değer
geocode()
çağrısının tamamlanmasının ardından 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
.
v=beta
kullanılırken const {GeocoderStatus} = await google.map.importLibrary("geocoding")
kullanılarak arama yapılabilir. Maps JavaScript API'deki kitaplıklar konusuna bakın.
Sabitler | |
---|---|
ERROR |
Google sunucularıyla iletişim kurulurken bir sorun oluştu. |
INVALID_REQUEST |
Bu GeocoderRequest geçersizdi. |
OK |
Yanıtta geçerli bir GeocoderResponse var. |
OVER_QUERY_LIMIT |
Web sayfası, istek sınırını çok kısa bir süre içinde aştı. |
REQUEST_DENIED |
Web sayfasının coğrafi kodlamayı kullanmasına izin verilmiyor. |
UNKNOWN_ERROR |
Bir 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
Geocoder
tarafından döndürülen ve GeocoderResult
listelerinin listesini içeren bir Geocoder yanıtı.
Özellikler | |
---|---|
results |
Tür:
Array<GeocoderResult> GeocoderResult adlı mülkün listesi. |
GeocoderResult arayüz
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 sonuç "JSON benzeri" olsa da dolaylı olarak bir LatLng
nesnesi içerdiği için kesinlikle JSON değildir.
Özellikler | |
---|---|
address_components |
GeocoderAddressComponent saniyelik diziler |
formatted_address |
Tür:
string Bu konumun kullanıcılar tarafından okunabilir adresini içeren bir dize. |
geometry |
Tür:
GeocoderGeometry GeocoderGeometry nesnesi |
place_id |
Tür:
string Konumla ilişkili yer kimliği. Yer kimlikleri, bir yeri Google Yerler veritabanında ve Google Haritalar'da benzersiz bir şekilde tanımlar. Yerler API'si geliştirici kılavuzunda Yer Kimlikleri hakkında daha fazla bilgi edinebilirsiniz. |
types |
Tür:
Array<string> İade edilen coğrafi kodlamalı öğ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 kodlama isteğinin, istenen adresin bir kısmıyla eşleşebilmesine rağmen, orijinal istek için tam eşleşme döndürmeyip döndürmediği. Tam eşleşme için değer undefined olur. |
plus_code optional |
Tür:
PlacePlusCode optional Konumla ilişkili artı kodu. |
postcode_localities optional |
Tür:
Array<string> optional Posta kodundaki tüm şehirleri belirten bir dize dizisi. Bu, yalnızca sonuç birden fazla şehir içeren bir posta kodu olduğunda geçerlidir. |
GeocoderAddressBileşen 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ış kısa 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 öğesinin görüntülenmesi 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
Coğrafi kodlamadan 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
.
v=beta
kullanılırken const {GeocoderLocationType} = await google.map.importLibrary("geocoding")
kullanılarak arama yapılabilir. Maps JavaScript API'deki kitaplıklar konusuna bakın.
Sabitler | |
---|---|
APPROXIMATE |
Döndürülen sonuç yaklaşıktır. |
GEOMETRIC_CENTER |
Döndürülen sonuç, bu tür bir çizginin (ör. sokak) veya poligonun (bölge) geometrik merkezidir. |
RANGE_INTERPOLATED |
Döndürülen sonuç, yaklaşık olarak iki nokta (ör. kavşaklar) arasındaki tahmini bir değeri (genellikle yol üzerindedir) yansıtır. Açık adres, genellikle bir açık adres için coğrafi kodlamanın kullanılamadığı durumlarda döndürülür. |
ROOFTOP |
Döndürülen sonuç, coğrafi kodlamanın tam olarak ne anlama geldiğini belirtir. |