Places Widgets

PlaceAutocompleteElement sınıfı

google.maps.places.PlaceAutocompleteElement sınıf

PlaceAutocompleteElement, Yerler Otomatik Tamamlama API'si için bir kullanıcı arayüzü bileşeni sağlayan bir HTMLElement alt sınıfıdır.

Özel öğe:
<gmp-place-autocomplete name="string" requested-language="string" requested-region="string" types="type1 type2 type3..."></gmp-place-autocomplete>

Bu sınıfın kapsamı HTMLElement.

Bu sınıf PlaceAutocompleteElementOptions yöntemini uyguluyor.

const {PlaceAutocompleteElement} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki Kitaplıklar konusuna bakın.
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
Parametreler: 
componentRestrictions
Tür:  ComponentRestrictions optional
Bileşen kısıtlamaları. Bileşen kısıtlamaları, tahminleri yalnızca üst bileşende bulunanlarla kısıtlamak için kullanılır. Örneğin, ülke.
locationBias
Tür:  LocationBias optional
Yer ararken kullanılacak yumuşak bir sınır veya ipucu.
locationRestriction
Tür:  LocationRestriction optional
Arama sonuçlarını sınırlandırmak için sınırlar.
name
Tür:  string optional
Giriş öğesi için kullanılacak ad. Ayrıntılar için https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name sayfasına bakın. Girişler için ad özelliğiyle aynı davranışı izler. Bunun bir form gönderildiğinde kullanılacak ad olduğunu unutmayın. Ayrıntılar için https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form sayfasını inceleyin.
HTML özelliği:
  • <gmp-placeautocomplete name="string"></gmp-placeautocomplete>
requestedLanguage
Tür:  string optional
Mümkünse, sonuçların döndürülmesi gereken dil için dil tanımlayıcısı. Seçilen dildeki sonuçlara daha yüksek bir sıralama verilebilir, ancak öneriler bu dille sınırlı değildir. Desteklenen dillerin listesine bakın.
HTML özelliği:
  • <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion
Tür:  string optional
Sonuç biçimlendirme ve sonuç filtreleme için kullanılan bir bölge kodu. Önerileri bu ülkeyle kısıtlamaz. Bölge kodu, iki karakterden oluşan bir ccTLD ("üst düzey alan") değerini kabul eder. Çoğu ccTLD kodu, bazı önemli istisnalar dışında ISO 3166-1 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk) ve ISO 3166-1 kodu "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallık'ı" için kullanılır).
HTML özelliği:
  • <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
types
Tür:  Array<string> optional
Döndürülecek tahmin türleri. Desteklenen türler için geliştirici kılavuzuna bakın. Hiçbir tür belirtilmezse tüm türler döndürülür.
HTML özelliği:
  • <gmp-place-autocomplete types="type1 type2 type3..."></gmp-place-autocomplete>
prediction-item
Tahmin açılır menüsünde tek bir tahmini temsil eden öğedir.
prediction-item-icon
Tahmin listesindeki her bir öğenin solunda gösterilen simge.
prediction-item-main-text
Tahminin ana metni olan tahmin öğesinin bir parçasıdır. Coğrafi konumlar için "Sidney" gibi bir yer adı veya "10 King Street" gibi sokak adı ve numarası içerir. Varsayılan olarak, tahmin-öğesi-ana metni siyah renklidir. Tahmin öğesinde ek metin varsa bu metin tahmin-öğesi-ana metninin dışındadır ve stilini tahmin öğesinden devralır. Varsayılan olarak gri renktedir. Ek metin genellikle bir adrestir.
prediction-item-match
Döndürülen tahminin, kullanıcı girişiyle eşleşen kısmı. Varsayılan olarak, bu eşleşen metin kalın metinle vurgulanır. Eşleşen metnin, tahmin öğesi içinde herhangi bir yerde olabileceğini unutmayın. Bu, tahmin-öğesi-ana metninin bir parçası olmayabilir.
prediction-item-selected
Kullanıcı klavyeyi kullanarak bir öğeye gittiğinde öğe. Not: Seçilen öğeler, hem bu parça stillerinden hem de tahmin öğesi parça stillerinden etkilenir.
prediction-list
Otomatik Yer Tamamlama hizmeti tarafından döndürülen tahminlerin listesini içeren görsel öğe. Bu liste, PlaceAutocompleteElement öğesinin altında bir açılır liste olarak görünür.
BetaaddEventListener
addEventListener(type, listener[, options])
Parametreler: 
  • type:  string Dinlenecek etkinlik türünü temsil eden büyük/küçük harfe duyarlı bir dize.
  • listener:  EventListener|EventListenerObject Bildirim alan nesne. Bu,HandleEvent yöntemine sahip bir işlev veya nesne olmalıdır
  • options:  boolean|AddEventListenerOptions optional Seçenekleri inceleyin. Özel etkinlikler yalnızca capture ve passive özelliklerini destekler.
Dönüş Değeri:  void
Belirtilen etkinlik hedefe her teslim edildiğinde çağrılacak bir işlev ayarlar. Bkz. addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametreler: 
Dönüş Değeri:  void
Daha önce addEventListener hizmetine kaydedilmiş bir etkinlik işleyiciyi hedeften kaldırır. Bkz. removeEventListener
gmp-placeselect
function(placeAutocompletePlaceSelectEvent)
Bağımsız değişkenler: 
Bu etkinlik, kullanıcı bir yer tahmini seçtiğinde tetiklenir. Bir Yer nesnesi içerir.
gmp-requesterror
function(placeAutocompleteRequestErrorEvent)
Bağımsız değişkenler: 
Bu etkinlik, arka uca yapılan bir istek reddedildiğinde tetiklenir (ör. yanlış API anahtarı). Bu etkinlik baloncuk olarak gösterilmiyor.

PlaceAutocompleteElementOptions arayüzü

google.maps.places.PlaceAutocompleteElementOptions arayüz

PlaceAutocompleteElement oluşturma seçenekleri.
componentRestrictions optional
Tür:  ComponentRestrictions optional
Göz atın: PlaceAutocompleteElement.componentRestrictions
locationBias optional
Tür:  LocationBias optional
Göz atın: PlaceAutocompleteElement.locationBias
locationRestriction optional
Tür:  LocationRestriction optional
Göz atın: PlaceAutocompleteElement.locationRestriction
requestedLanguage optional
Tür:  string optional
Göz atın: PlaceAutocompleteElement.requestedLanguage
requestedRegion optional
Tür:  string optional
Göz atın: PlaceAutocompleteElement.requestedRegion
types optional
Tür:  Array<string> optional
Göz atın: PlaceAutocompleteElement.types

PlaceAutocompletePlaceSelectEvent sınıfı

google.maps.places.PlaceAutocompletePlaceSelectEvent sınıf

Bu etkinlik, kullanıcı Otomatik Yer Tamamlama Öğesi ile bir yer seçtikten sonra oluşturulur. event.place ile seçime erişin.

Bu sınıfın kapsamı Event.

const {PlaceAutocompletePlaceSelectEvent} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki Kitaplıklar konusuna bakın.
Betaplace
Tür:  Place

PlaceAutocompleteRequestErrorEvent sınıf

google.maps.places.PlaceAutocompleteRequestErrorEvent sınıf

Bu etkinlik, ağ isteğiyle ilgili bir sorun olduğunda PlaceAutocompleteElement tarafından yayınlanır.

Bu sınıfın kapsamı Event.

const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki Kitaplıklar konusuna bakın.

Autocomplete sınıf

google.maps.places.Autocomplete sınıf

Bir kullanıcının metin girişine göre Yer tahminleri sağlayan bir widget. text türündeki bir giriş öğesine eklenir ve bu alandaki metin girişini dinler. Tahminler listesi açılır liste olarak sunulur ve metin girildikçe güncellenir.

Bu sınıfın kapsamı MVCObject.

const {Autocomplete} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki Kitaplıklar konusuna bakın.
Autocomplete
Autocomplete(inputField[, opts])
Parametreler: 
Verilen seçeneklerle belirtilen giriş metni alanına eklenen yeni bir Autocomplete örneği oluşturur.
getBounds
getBounds()
Parametreler: Yok
Dönüş Değeri:  LatLngBounds|undefined Ağırlık verme sınırları.
Tahminlerin eğilimli olduğu sınırları döndürür.
getFields
getFields()
Parametreler: Yok
Dönüş Değeri:  Array<string>|undefined
Ayrıntılar başarıyla alındığında, ayrıntılar yanıtına Yer için dahil edilecek alanları döndürür. Alanların listesi için bkz. PlaceResult.
getPlace
getPlace()
Parametreler: Yok
Dönüş Değeri:  PlaceResult Kullanıcı tarafından seçilen yer.
Ayrıntılar başarılı bir şekilde alındıysa kullanıcı tarafından seçilen Yerin ayrıntılarını döndürür. Aksi takdirde, name özelliği giriş alanının geçerli değerine ayarlanmış bir saplama Place nesnesi döndürür.
setBounds
setBounds(bounds)
Parametreler: 
Return Value: Yok
Yer sonuçlarının döndürüleceği tercih edilen alanı ayarlar. Sonuçlar bu alana yöneliktir, ancak bununla sınırlı değildir.
setComponentRestrictions
setComponentRestrictions(restrictions)
Parametreler: 
Return Value: Yok
Bileşen kısıtlamalarını ayarlar. Bileşen kısıtlamaları, tahminleri yalnızca üst bileşende bulunanlarla kısıtlamak için kullanılır. Örneğin, ülke.
setFields
setFields(fields)
Parametreler: 
  • fields:  Array<string> optional
Return Value: Yok
Ayrıntılar başarıyla alındığında, Yer için ayrıntılar yanıtına eklenecek alanları ayarlar. Alanların listesi için bkz. PlaceResult.
setOptions
setOptions(options)
Parametreler: 
Return Value: Yok
setTypes
setTypes(types)
Parametreler: 
  • types:  Array<string> optional Dahil edilecek tahmin türleri.
Return Value: Yok
Döndürülecek tahmin türlerini ayarlar. Desteklenen türler için geliştirici kılavuzuna bakın. Hiçbir tür belirtilmezse tüm türler döndürülür.
Devralındı: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, kullanıcının seçtiği bir Yer için bir PlaceResult kullanılabildiğinde tetiklenir.
Kullanıcı, kontrol tarafından önerilmeyen bir Yerin adını girip Enter tuşuna basarsa veya Yer Ayrıntıları isteği başarısız olursa PlaceResult, başka hiçbir özellik tanımlanmadan name özelliğindeki kullanıcı girişini içerir.

AutocompleteOptions arayüzü

google.maps.places.AutocompleteOptions arayüz

Bir Autocomplete nesnesinde ayarlanabilen seçenekler.
bounds optional
Yerlerin aranacağı alan.
componentRestrictions optional
Tür:  ComponentRestrictions optional
Bileşen kısıtlamaları. Bileşen kısıtlamaları, tahminleri yalnızca üst bileşende bulunanlarla kısıtlamak için kullanılır. Örneğin, ülke.
fields optional
Tür:  Array<string> optional
Ayrıntılar başarıyla alındığında, Yer için ayrıntılar yanıtına eklenecek ve bunlar için faturalandırılacak alanlar. ['ALL'] geçirilirse mevcut tüm alanlar döndürülür ve bunlar için faturalandırılırsınız (bu, üretim dağıtımları için önerilmez). Alanların listesi için bkz. PlaceResult. İç içe alanlar nokta yollarıyla belirtilebilir (örneğin, "geometry.location"). Varsayılan olarak ['ALL'] kullanılır.
placeIdOnly optional
Tür:  boolean optional
Yalnızca Yer Kimliklerinin alınıp alınmayacağı. Place_changed etkinliği tetiklendiğinde kullanıma sunulan PlaceResult yalnızca yer_kimliği, türler ve ad alanlarını içerir. Bu alanlar ve Otomatik Tamamlama hizmeti tarafından döndürülen yer_kimliği, türler ve açıklama. Varsayılan olarak devre dışıdır.
strictBounds optional
Tür:  boolean optional
Otomatik tamamlama widget'ının, sorgu gönderildiği sırada yalnızca Otomatik Tamamlama widget'ının sınırları içinde kalan yerleri döndürmesi gerektiğini belirten bir boole değeridir. strictBounds değerini false (varsayılan) değerine ayarlamak, sonuçların sınırlar içindeki yerlere ağırlık vermesine ancak bunlarla sınırlı olmamasına neden olur.
types optional
Tür:  Array<string> optional
Döndürülecek tahmin türleri. Desteklenen türler için geliştirici kılavuzuna bakın. Hiçbir tür belirtilmezse tüm türler döndürülür.

google.maps.places.SearchBox sınıf

Bir kullanıcının metin girişine göre sorgu tahminleri sağlayan bir widget. text türündeki bir giriş öğesine eklenir ve bu alandaki metin girişini dinler. Tahminler listesi açılır liste olarak sunulur ve metin girildikçe güncellenir.

Bu sınıfın kapsamı MVCObject.

const {SearchBox} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki Kitaplıklar konusuna bakın.
SearchBox
SearchBox(inputField[, opts])
Parametreler: 
Verilen seçeneklerle belirtilen giriş metni alanına eklenen yeni bir SearchBox örneği oluşturur.
getBounds
getBounds()
Parametreler: Yok
Dönüş Değeri:  LatLngBounds|undefined
Sorgu tahminlerinin ağırlık verdiği sınırları döndürür.
getPlaces
getPlaces()
Parametreler: Yok
Dönüş Değeri:  Array<PlaceResult>|undefined
places_changed etkinliğiyle kullanılmak üzere kullanıcı tarafından seçilen sorguyu döndürür.
setBounds
setBounds(bounds)
Parametreler: 
Return Value: Yok
Sorgu tahminlerine ağırlık vermek için kullanılacak bölgeyi ayarlar. Sonuçlar yalnızca bu alana yönelik olur ve tamamen bu alanla sınırlı olmaz.
Devralındı: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, kullanıcı bir sorgu seçtiğinde tetiklenir. Yeni yerler almak için getPlaces kullanılmalıdır.

SearchBoxOptions arayüzü

google.maps.places.SearchBoxOptions arayüz

Bir SearchBox nesnesinde ayarlanabilen seçenekler.
bounds optional
Sorgu tahminlerine ağırlık verilecek alan. Tahminler, bu sınırları hedefleyen sorgulara ağırlık verir ancak bunlarla sınırlı değildir.