Geocoder

Geocoder sınıfı

google.maps.Geocoder sınıf

Adres ile LatLng arasında dönüşüm yapmaya yarayan 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.
Geocoder
Geocoder()
Parametreler: Yok
Google sunucularına coğrafi kod isteği gönderen bir Geocoder öğesinin yeni bir örneğini oluşturur.
geocode
geocode(request[, callback])
Parametreler: 
İade Değeri:  Promise<GeocoderResponse>
Bir isteği coğrafi kodlayın.

GeocoderRequest arayüzü

google.maps.GeocoderRequest arayüz

Geocoder'a gönderilecek bir coğrafi kodlama isteğinin tanımı.
address optional
Tür:  string optional
Coğrafi kodlanacak adres. address, location ve placeId özelliklerinden yalnızca biri sağlanmalıdır.
bounds optional
LatLngBounds içinde arama yapılacak metin. İsteğe bağlı.
componentRestrictions optional
Bileşenler, sonuçları belirli bir alanla sınırlamak için kullanılır. Filtreler şunlardan birini 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 ek hesaplamaların listesi. Not: Bu ek hesaplamalar, yanıtta ek alanlar döndürebilir.
fulfillOnZeroResults optional
Tür:  boolean optional
Yanıtın ZERO_RESULT durumunda sözü yerine getirin. Coğrafi kodlama sonucu olmasa bile yanıt düzeyinde ek alanlar döndürülebildiği için bu durum istenebilir.
language optional
Tür:  string optional
Mümkün olduğunda sonuçların döndürülmesi gereken dilin 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ı, tersine coğrafi kodlama gerçekleştirir. Daha fazla bilgi için Ters Coğrafi Kodlama bölümüne bakın. 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 Places 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 gerçekleştirir. Daha fazla bilgi için Ters 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
Aramayı yönlendirmek için kullanılan ülke kodu, iki 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 alanı belirleyen bir filtre grubunu temsil eder. Bu özelliğin işleyiş şekliyle ilgili ayrıntılar için Geokodlama Bileşeni Filtreleme başlıklı makaleyi inceleyin.
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
route uzun veya kısa adıyla eşleşir. İsteğe bağlı.

ExtraGeocodeComputation sabitleri

google.maps.ExtraGeocodeComputation sabitler

Coğrafi kodlama isteği tamamlanırken gerçekleştirilecek ek hesaplamalar.

const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
ADDRESS_DESCRIPTORS Adres tanımlayıcısı oluşturun.

GeocoderStatus sabitleri

google.maps.GeocoderStatus sabitler

Geocoder tarafından geocode() ile yapılan bir görüşme tamamlandığında döndürülen durum. Bunları değerle veya sabitin adını kullanarak belirtebilirsiniz. Ö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.
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 Bir 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 listesini içeren Geocoder tarafından döndürülen bir Geocoder yanıtı.GeocoderResult
results
GeocoderResult listesi.
Betaaddress_descriptor optional
Tür:  AddressDescriptor optional
Bir konumun ilişkisel açıklaması. Yakındaki önemli noktaların ve hedef konumu içeren alanların sıralanmış bir kümesini 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 Plus Code.

GeocoderResult arayüzü

google.maps.GeocoderResult arayüz

Coğrafi kod sunucusundan alınan tek bir coğrafi kodlayıcı sonucu. Bir coğrafi kod isteği birden fazla sonuç nesnesi döndürebilir. Bu sonucun "JSON benzeri" olmasına rağmen, 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ın okuyabileceği adresini içeren bir dize.
geometry
GeocoderGeometry nesnesi
place_id
Tür:  string
Konumla ilişkili yer kimliği. Yer kimlikleri, Google Places 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 kodlu öğenin türünü belirten bir dizeler 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şkili konumun ilişkisel açıklaması. Yakındaki önemli noktaların ve hedef konumu içeren alanların sıralanmış bir kümesini içerir. Bu alan yalnızca ileri 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
Kod çözücü, istenen adresin bir kısmını eşleştirebilse de orijinal istek için tam eşleşme döndürmedi. 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 yerleşim yerlerini belirten dizeler dizisi. Bu yalnızca sonuç birden fazla yerleşim birimi içeren bir posta kodu olduğunda gösterilir.

AddressDescriptor arayüzü

google.maps.AddressDescriptor arayüz

Bir konumun ilişkisel açıklaması. Yakındaki önemli noktaların ve hedef konumu içeren alanların sıralanmış bir kümesini içerir.
areas
Tür:  Array<Area>
İçeren veya bitişik alanların sıralı listesi. En yararlı (tanınabilir ve hassas) alanlar ilk sırada yer alır.
landmarks
Tür:  Array<Landmark>
Yakındaki önemli noktaların sıralı listesi. En kullanışlı (tanınabilir ve yakındaki) önemli noktalar ilk sırada yer alı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ış, kısa metni
types
Tür:  Array<string>
Bu adres bileşeninin türünü belirten dizeler dizisi. Geçerli türlerin listesini burada bulabilirsiniz.

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
Bu GeocoderResult öğesinin tam sınırları (varsa)

GeocoderLocationType sabitleri

google.maps.GeocoderLocationType sabitler

Bir coğrafi koddan döndürülen konumun türünü açıklar. Bunları değerle veya sabitin adını kullanarak belirtebilirsiniz. Ö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.
APPROXIMATE Döndürülen sonuç yaklaşık değerdir.
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 (ör. kavşaklar) arasında enterpolasyon yapılan bir yaklaştırmayı (genellikle bir yol üzerinde) yansıtır. Bir sokak adresi için çatı coğrafi kodları kullanılamadığında genellikle enterpolasyonlu sonuçlar döndürülür.
ROOFTOP Döndürülen sonuç, tam bir coğrafi kodu yansıtır.

Önemli nokta arayüzü

google.maps.Landmark arayüz

Adres için referans noktası olan 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
Referans noktası olarak kullanılan temel tesisin yer kimliği. Mekanın ayrıntıları veya yer kimliği araması aracılığıyla önemli nokta hakkında daha fazla bilgi edinmek 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 yer işareti 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 ayrıntılı bilgi için lütfen Türler bölümüne bakın.
travel_distance_meters optional
Tür:  number optional
Hedef konum ile önemli nokta arasındaki yol ağında seyahat mesafesi. Hedefin en yakın olduğu yol ağının bir parçasıyla bağlantısı kesilmişse VEYA hedef konumun aslında yol ağında olmadığı düşünülüyorsa bu alan boş bırakılabilir.

Area arayüzü

google.maps.Area arayüz

Bir mahalle, alt yerleşim birimi veya hedef konumu içeren büyük bir 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 için ad.
display_name_language_code
Tür:  string
Alan adının dili.
place_id
Tür:  string
Temel alanın yer kimliği. Mekanın ayrıntıları veya yer kimliği araması aracılığıyla bölge hakkında daha fazla bilgi edinmek için kullanılabilir.

Kapsama sabitleri

google.maps.Containment sabitler

Alan ile hedef konum arasındaki mekansal ilişkiyi temsil eden bir enum.

const {Containment} = await google.maps.importLibrary("geocoding") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
NEAR Hedef konum, bölge alanının dışında ancak yakında.
OUTSKIRTS Hedef konum, alan bölgesinin içinde ve kenara yakındır.
WITHIN Hedef konum, alan bölgesinin içinde ve merkeze yakındır.

SpatialRelationship sabitleri

google.maps.SpatialRelationship sabitler

Yer işareti ile hedef arasındaki uzamsal ilişkiyi temsil eden bir enum.

const {SpatialRelationship} = await google.maps.importLibrary("geocoding") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
ACROSS_THE_ROAD Hedef, yolun diğer tarafındaki yer işaretinin tam karşısında.
AROUND_THE_CORNER Önemli yerle aynı rota üzerinde değil ancak tek bir dönüş uzaklığında.
BEHIND Anıtın yapısına yakın ancak erişim noktasından daha uzakta.
BESIDE Hedef, doğrudan yer işaretinin bitişiğindedir.
DOWN_THE_ROAD Yer işaretiyle aynı rota üzerinde ancak yanında veya karşısında değil.
NEAR Aşağıda daha spesifik bir durum söz konusu değilse varsayılan ilişki budur.
WITHIN Önemli noktanın uzamsal geometrisi var ve hedef, bu geometrinin sınırları içinde.