Geocoder

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.
Geocoder
Geocoder()
Parametreler: Yok
Google sunucularına coğrafi kodlama istekleri gönderen yeni bir Geocoder örneği oluşturur.
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.
address optional
Tür:  string optional
Coğrafi kodlama adresi. address, location ve placeId özelliklerinden yalnızca biri sağlanmalıdır.
bounds optional
İçinde arama yapılacağı LatLngBounds. İsteğe bağlı.
componentRestrictions 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ı.
BetaextraComputations optional
Tür:  Array<ExtraGeocodeComputation> optional
İsteği tamamlamak için kullanılabilecek ekstra hesaplamaların listesi. Not: Bu ekstra hesaplamalar yanıtta fazladan alanlar döndürebilir.
fulfillOnZeroResults optional
Tür:  boolean optional
Yanıtta ZERO_RESULT durumuyla ilgili sözünü yerine getir. Coğrafi kodlama sonucu sıfır olsa bile ek yanıt düzeyi alanları döndürülebileceği için bu tercih edilebilir.
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.
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ı.

ExtraGeocodeComputation sabit değerleri

google.maps.ExtraGeocodeComputation sabit değer

Coğrafi kodlama isteği tamamlanırken yapılacak ekstra hesaplamalar.

const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki Kitaplıklar konusuna bakın.
ADDRESS_DESCRIPTORS Adres açıklayıcı oluşturun.

GeocoderStatus sabit değerleri

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.
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ı.
results
GeocoderResult listesi.
Betaaddress_descriptor optional
Tür:  AddressDescriptor optional
Bir yerin ilişkisel açıklaması. Yakındaki önemli noktaların sıralı bir kümesini ve hedef konumu içeren alanları içerir. Yalnızca ters coğrafi kodlama istekleri için ve yalnızca ExtraGeocodeComputation.ADDRESS_DESCRIPTORS etkinleştirildiğinde doldurulur.
plus_code optional
Tür:  PlacePlusCode optional
Konumla ilişkili artı kodu.

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.
address_components
GeocoderAddressComponent dizisi
formatted_address
Tür:  string
Bu konumun kullanıcılar tarafından okunabilen adresini içeren bir dize.
geometry
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.
Betaaddress_descriptor optional
Tür:  AddressDescriptor optional
Bu coğrafi kodla ilişkilendirilen konumun ilişkisel açıklaması. Yakındaki önemli noktaların sıralı bir kümesini ve hedef konumu içeren alanları içerir. Bu alan, yalnızca ileriye yönelik coğrafi kodlama ve yer kimliği arama istekleri için, yalnızca ExtraGeocodeComputation.ADDRESS_DESCRIPTORS etkinleştirildiğinde ve yalnızca belirli yerelleştirilmiş yerler için doldurulur.
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.

AddressDescriptor arayüzü

google.maps.AddressDescriptor arayüz

Bir yerin ilişkisel açıklaması. Yakındaki önemli noktaların sıralı bir kümesini ve hedef konumu içeren alanları içerir.
areas
Tür:  Array<Area>
Bulunduğu veya bitişik bölgelerin sıralı listesi. En yararlı (tanınabilir ve kesin) alanlar listenin başında yer alır.
landmarks
Tür:  Array<Landmark>
Yakındaki önemli noktaların sıralı listesi. En faydalı (tanınabilir ve yakındaki) önemli noktalar en üstte sıralanır.

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.
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
location
Tür:  LatLng
Bu sonucun enlem/boylam koordinatları
location_type
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.
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.

Önemli nokta arayüzü

google.maps.Landmark arayüz

Adres için bir referans noktasını temsil eden bir yer.
display_name
Tür:  string
Önemli noktanın adı.
display_name_language_code
Tür:  string
Önemli noktanın adının dili.
place_id
Tür:  string
Önemli nokta olarak işlev gören temel tesisin yer kimliği. Yer Ayrıntıları veya Yer Kimliği Araması aracılığıyla önemli noktayla ilgili daha fazla bilgiyi çözümlemek için kullanılabilir.
spatial_relationship
Hedef konum ile önemli nokta arasındaki mekansal ilişkiyi tanımlar.
straight_line_distance_meters
Tür:  number
Hedef konum ile önemli nokta arasındaki düz çizgi mesafesi.
types
Tür:  Array<string>
Döndürülen sonucun türünü belirten bir veya daha fazla değer. Daha fazla bilgi için lütfen Türler bölümünü inceleyin.
travel_distance_meters optional
Tür:  number optional
Yol ağı boyunca hedef konum ile önemli nokta arasındaki seyahat mesafesi. Bu alan, yer işareti ile hedefin yol ağının en yakın olduğu kısmı arasındaki bağlantı kesilirse VEYA hedef konumun yol ağında yer almadığı düşünülmüyorsa bu alan doldurulamaz.

Alan arayüzü

google.maps.Area arayüz

Hedef konumu içeren mahalle, alt konum veya büyük kompleks gibi küçük bir bölge olan yer.
containment
Tür:  Containment
Hedef konum ile alan arasındaki mekansal ilişkiyi tanımlar.
display_name
Tür:  string
Alanın adı.
display_name_language_code
Tür:  string
Bölge adının dili.
place_id
Tür:  string
Temel alanın yer kimliği. Yer Ayrıntıları veya Yer Kimliği Araması aracılığıyla bölgeyle ilgili daha fazla bilgiye ulaşmak için kullanılabilir.

İçerme sabitleri

google.maps.Containment sabit değer

Alan ve hedef konum arasındaki mekansal ilişkiyi temsil eden bir numaralandırma.

const {Containment} = await google.maps.importLibrary("geocoding") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki Kitaplıklar konusuna bakın.
NEAR Hedef konum bu alanın dışında, ancak yakınında bulunuyor.
OUTSKIRTS Hedef konum, sınıra yakın bir bölge içinde yer alıyor.
WITHIN Hedef konum, merkeze yakın bir bölgede yer alıyor.

SpatialRelationship sabitleri

google.maps.SpatialRelationship sabit değer

Önemli nokta ile hedef arasındaki uzayda ilişkiyi temsil eden bir numaralandırma.

const {SpatialRelationship} = await google.maps.importLibrary("geocoding") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki Kitaplıklar konusuna bakın.
ACROSS_THE_ROAD Hedef, yolun diğer tarafındaki önemli noktanın tam karşısındadır.
AROUND_THE_CORNER Önemli nokta ile aynı rotada değil, bir dönüşte.
BEHIND Önemli noktanın yapısına yakın ancak erişim noktasından daha uzakta.
BESIDE Hedef, önemli noktanın doğrudan bitişiğindedir.
DOWN_THE_ROAD Önemli nokta ile aynı rotada ancak yanında veya üzerinden değil.
NEAR Aşağıda daha spesifik hiçbir koşul söz konusu olmadığında varsayılan ilişki budur.
WITHIN Önemli nokta uzamsal bir geometriye sahip ve hedef kendi sınırları içinde.