Geocoder

Geocoder sınıfı

google.maps.Geocoder sınıf
kitaplık "geocoding"

Adres ile LatLng arasında dönüşüm sağlayan bir hizmet.

const {Geocoder} = await google.maps.importLibrary("geocoding");
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önüş Değeri: Promise<GeocoderResponse>
Bir isteği coğrafi olarak kodlama

GeocoderRequest arayüzü

google.maps.GeocoderRequest arayüz

Geocoder hizmetine gönderilecek coğrafi kodlama isteğinin spesifikasyonu.
address
isteğe bağlı
Tür: string optional
Coğrafi kodlanacak adres. address, location ve placeId özelliklerinden yalnızca biri sağlanmalıdır.
bounds
isteğe bağlı
Arama yapılacak LatLngBounds. İsteğe bağlıdır.
componentRestrictions
isteğe bağlı
Bileşenler, sonuçları belirli bir alanla kısıtlamak 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şleme yöntemlerini destekler. İsteğe bağlıdır.
BetaextraComputations
isteğe bağlı
İsteği tamamlamak için kullanılabilecek ek hesaplamaların listesi. Not: Bu ek hesaplamalar, yanıtta ek alanlar döndürebilir.
fulfillOnZeroResults
isteğe bağlı
Tür: boolean optional
Yanıttaki ZERO_RESULT durumunda verilen sözü yerine getirin. Sıfır coğrafi kodlama sonucu olsa bile ek yanıt düzeyi alanları döndürülebileceğinden bu durum tercih edilebilir.
language
isteğe bağlı
Tür: string optional
Mümkün olduğunda sonuçların döndürülmesi gereken dil için bir dil tanımlayıcı. Desteklenen dillerin listesine bakın.
location
isteğe bağlı
Tür: LatLng|LatLngLiteral optional
Aranacak LatLng (veya LatLngLiteral). Coğrafi kodlayıcı, tersine coğrafi kodlama işlemi gerçekleştirir. Daha fazla bilgi için Tersine Coğrafi Kodlama başlıklı makaleyi inceleyin. address, location ve placeId özelliklerinden yalnızca biri sağlanmalıdır.
placeId
isteğe bağlı
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 edinebilirsiniz. Coğrafi kodlayıcı, tersine coğrafi kodlama işlemi gerçekleştirir. Daha fazla bilgi için Tersine Coğrafi Kodlama bölümüne bakın. address, location ve placeId özelliklerinden yalnızca biri sağlanmalıdır.
region
isteğe bağlı
Tür: string optional
Aramayı yönlendirmek için kullanılan ülke kodu. İki karakterli (sayısal olmayan) bir Unicode bölge alt etiketi/CLDR tanımlayıcısı olarak belirtilir. İsteğe bağlıdır. 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 çözümlenen bir filtre grubunu temsil eder. Bu özelliğin işleyiş şekliyle ilgili ayrıntılı bilgi için Coğrafi Kodlama Bileşen Filtreleme başlıklı makaleyi inceleyin.
administrativeArea
isteğe bağlı
Tür: string optional
Tüm administrative_area levels ile eşleşir. İsteğe bağlıdır.
country
isteğe bağlı
Tür: string optional
Bir ülke adı veya iki harfli ISO 3166-1 ülke koduyla eşleşir. İsteğe bağlıdır.
locality
isteğe bağlı
Tür: string optional
Hem locality hem de sublocality türleriyle eşleşir. İsteğe bağlıdır.
postalCode
isteğe bağlı
Tür: string optional
postal_code ve postal_code_prefix ile eşleşir. İsteğe bağlıdır.
route
isteğe bağlı
Tür: string optional
Bir route öğesinin uzun veya kısa adıyla eşleşir. İsteğe bağlıdır.

ExtraGeocodeComputation sabitleri

google.maps.ExtraGeocodeComputation sabitleri
kitaplığı "geocoding"

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

Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri ExtraGeocodeComputationString türüyle tanımlanır.

const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding");
ADDRESS_DESCRIPTORS Adres tanımlayıcı oluşturun.

GeocoderStatus sabitleri

google.maps.GeocoderStatus sabitleri
kitaplığı "geocoding"

geocode() çağrısı tamamlandığında 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.

Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri GeocoderStatusString türüyle tanımlanır.

const {GeocoderStatus} = await google.maps.importLibrary("geocoding");
ERROR Google sunucularıyla bağlantı kurulurken bir 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şmıştır.
REQUEST_DENIED Web sayfasının coğrafi kodlayıcıyı kullanmasına izin verilmiyor.
UNKNOWN_ERROR Sunucu hatası nedeniyle bir 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 listesini içeren bir Geocoder yanıtı.
results
GeocoderResult listesi.
Betaaddress_descriptor
isteğe bağlı
Tür: AddressDescriptor optional
Bir konumun ilişkisel açıklaması. Yakındaki önemli noktaların ve hedef konumu içeren alanların sıralı bir listesini içerir. Yalnızca tersine coğrafi kodlama istekleri için ve yalnızca ExtraGeocodeComputation.ADDRESS_DESCRIPTORS etkinleştirildiğinde doldurulur.
plus_code
isteğe bağlı
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. 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 okunabilir 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 edinebilirsiniz.
types
Tür: Array<string>
Coğrafi kodlanmış öğenin türünü belirten 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
isteğe bağlı
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ıralı bir listesini içerir. Bu alan yalnızca ileriye doğru 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
isteğe bağlı
Tür: boolean optional
Coğrafi kodlayıcının, istenen adresin bir kısmını eşleştirebilmesine rağmen orijinal istekle tam eşleşme döndürüp döndürmediği. Tam eşleşme varsa değer undefined olur.
plus_code
isteğe bağlı
Tür: PlacePlusCode optional
Konumla ilişkili Plus Code.
postcode_localities
isteğe bağlı
Tür: Array<string> optional
Bir posta kodunda bulunan tüm yerleşim yerlerini belirten dize dizisi. Bu, yalnızca sonuç birden fazla yerleşim yeri 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ıralı bir listesini 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
Yakındaki önemli noktaların sıralı listesi. En faydalı (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
Verilen 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 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
Bu GeocoderResult öğesini görüntülemek için önerilen görüntü alanının sınırları
bounds
isteğe bağlı
Tür: LatLngBounds optional
Varsa bu GeocoderResult için kesin sınırlar

GeocoderLocationType sabitleri

google.maps.GeocoderLocationType sabitleri
kitaplığı "geocoding"

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.

Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri GeocoderLocationTypeString türüyle tanımlanır.

const {GeocoderLocationType} = await google.maps.importLibrary("geocoding");
APPROXIMATE Döndürülen sonuç yaklaşık değerdir.
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 enterpolasyonla hesaplanan bir yaklaşık değeri (genellikle bir yol üzerinde) yansıtır. Ara değer hesaplamalı sonuçlar genellikle bir açık adres için çatı coğrafi kodları kullanılamadığında 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 yerin adı.
display_name_language_code
Tür: string
Önemli noktanın adının dili.
place_id
Tür: string
Önemli nokta olarak kullanılan temel işletmenin yer kimliği. Yer Ayrıntıları veya Yer Kimliği Arama 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 önemli yer arasındaki düz çizgi mesafesi.
types
Tür: Array<string>
Döndürülen sonucun türünü gösteren bir veya daha fazla değer. Daha fazla bilgi için Türler bölümüne bakın.
travel_distance_meters
isteğe bağlı
Tür: number optional
Hedef konum ile önemli yer arasındaki yol ağı boyunca seyahat mesafesi. Önemli nokta, hedefin en yakın olduğu yol ağı bölümünden ayrılmışsa VEYA hedef konumun aslında yol ağında olduğu düşünülmüyorsa bu alan boş bırakılabilir.

Alan arayüzü

google.maps.Area arayüz

Hedef konumu içeren mahalle, alt yerleşim yeri veya büyük bir kompleks gibi küçük bir bölge olan yer.
containment
Hedef konum ile alan arasındaki mekansal ilişkiyi tanımlar.
display_name
Tür: string
Alan 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 Arama aracılığıyla bölge hakkında daha fazla bilgi edinmek için kullanılabilir.

Kapsama sabitleri

google.maps.Containment sabitleri
kitaplığı "geocoding"

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

Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri ContainmentString türüyle tanımlanır.

const {Containment} = await google.maps.importLibrary("geocoding");
NEAR Hedef konum, bölge alanının dışında ancak yakınında.
OUTSKIRTS Hedef konum, bölge içinde, kenara yakın bir yerde.
WITHIN Hedef konum, bölgenin içinde, merkeze yakın bir yerde.

SpatialRelationship sabitleri

google.maps.SpatialRelationship sabitleri
kitaplığı "geocoding"

Önemli nokta ile hedef arasındaki uzamsal ilişkiyi temsil eden bir enum.

Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri SpatialRelationshipString türüyle tanımlanır.

const {SpatialRelationship} = await google.maps.importLibrary("geocoding");
ACROSS_THE_ROAD Hedef, yolun diğer tarafındaki önemli noktanın tam karşısındadır.
AROUND_THE_CORNER Önemli noktayla aynı rotada değil ancak bir dönüş uzaklıkta.
BEHIND Önemli noktanın yapısına yakın ancak erişim noktasına daha uzak.
BESIDE Hedef, önemli noktanın hemen yanındadır.
DOWN_THE_ROAD Önemli yerle aynı güzergahta ancak yanında veya karşısında değil.
NEAR Aşağıda daha spesifik bir ilişki belirtilmediğinde varsayılan olarak bu ilişki kullanılır.
WITHIN Önemli yerin uzamsal bir geometrisi vardır ve hedef, bu geometrinin sınırları içindedir.