Geocoder

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.
Geocoder
Geocoder()
Parametreler: Yok
Google sunucularına coğrafi kod istekleri gönderen yeni bir Geocoder örneği oluşturur.
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.
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ılır. İsteğe bağlı.
componentRestrictions 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ı.
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ıtta ZERO_RESULT durumundaki vaadi yerine getirin. Bu, sıfır coğrafi kodlama sonucu olsa bile ek yanıt düzeyi alanları döndürülebileceği için istenebilir.
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.
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ı.

ExtraGeocodeComputation sabitleri

google.maps.ExtraGeocodeComputation constants

Coğrafi kodlama isteği tamamlanırken yapılacak 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 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.
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ı.
results
GeocoderResult değerlerinin 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ıralandığı bir grup içerir. Yalnızca ters coğrafi kodlama istekleri için ve yalnızca ExtraGeocodeComputation.ADDRESS_DESCRIPTORS etkinken doldurulur.
plus_code optional
Tür:  PlacePlusCode optional
Konumla ilişkili Plus Code.

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.
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 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.
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ıralandığı bir grup 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
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.

AddressDescriptor sınıfı

google.maps.AddressDescriptor arayüz

Bir konumun ilişkisel açıklaması. Yakındaki önemli noktaların ve hedef konumu içeren alanların sıralandığı bir grup içerir.
areas
Tür:  Array<Area>
İçerdiği veya bitişik olduğu alanların sıralandığı liste. En yararlı (tanınabilir ve hassas) alanlar öncelikli olarak sıralanır.
landmarks
Tür:  Array<Landmark>
Yakındaki önemli yerlerin sıralandığı liste. En yararlı (tanınabilir ve yakındaki) yer işaretleri öncelikli olarak sıralanır.

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

Ö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
Yer işareti olarak hizmet veren temel tesisin yer kimliği. Mekan ayrıntıları veya yer kimliği araması aracılığıyla önemli yer hakkında daha fazla bilgi almak için kullanılabilir.
spatial_relationship
Hedef konum ile yer işareti 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 yer işareti arasındaki yol ağındaki seyahat mesafesi. Bu alan, yer işaretinin hedefin en yakın olduğu yol ağının parçasıyla bağlantısı kesilirse VEYA hedef konumun aslında yol ağında olduğu kabul edilmezse boş bırakılabilir.

Alan arayüzü

google.maps.Area arayüz

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ın adı.
display_name_language_code
Tür:  string
Alanın adının dili.
place_id
Tür:  string
Temel alanın yer kimliği. Mekan Ayrıntıları veya Mekan Kimliği Arama özelliği aracılığıyla bölgeyle ilgili daha fazla bilgi edinmek için kullanılabilir.

Kapsayıcılık sabitleri

google.maps.Containment constants

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, alan bölgesinin dışında ancak yakınındadır.
OUTSKIRTS Hedef konum, alan bölgesinde, kenara yakın bir yerdedir.
WITHIN Hedef konum, alan bölgesinde ve merkeze yakındır.

SpatialRelationship sabitleri

google.maps.SpatialRelationship constants

Yer işareti ile hedef arasındaki uzaydaki 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ındadır.
AROUND_THE_CORNER Dönüm noktasının bulunduğu rota üzerinde değil, ancak bir dönüş uzaklıktadır.
BEHIND Önemli yerin yapısına yakın ancak erişim noktasından daha uzak.
BESIDE Hedef, işaretin hemen yanındadır.
DOWN_THE_ROAD Dönüm noktasıyla aynı rota üzerinde ancak yanında veya karşısında değil.
NEAR Aşağıda daha spesifik bir ilişki belirtilmemişse varsayılan ilişki budur.
WITHIN Dönüm noktası, bir mekansal geometriye sahiptir ve hedef, bu geometrinin sınırları içindedir.