Places Widgets

PlaceAutocompleteElement sınıfı

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

Places API için AutocompleteView özelliğinin uygulanması

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: 
element optional
Tür:  HTMLElement|SVGElement optional
Bu alan salt okunurdur. Görünümü destekleyen DOM Öğesi.
inputElement
Otomatik tamamlamaların gösterileceği giriş öğesi.
Devralınan: componentRestrictions, locationBias, locationRestriction, requestedLanguage, requestedRegion, types
addListener
addListener(eventName, handler)
Parametreler: 
  • eventName:  string
  • handler:  Function
Dönüş Değeri:  MapsEventListener
Belirtilen işleyici işlevini verilen etkinlik adına ekler.
gmp-placeselect
function(place)
Bağımsız değişkenler: 
Bu etkinlik, kullanıcı bir yer tahmini seçtiğinde tetiklenir. Bir Yer Nesnesi döndürür.
gmp-requesterror
function()
Bağımsız değişkenler: Yok
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.
inputElement
Otomatik tamamlamaların gösterileceği giriş öğesi.
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.
element optional
Tür:  HTMLElement|SVGElement optional
Bu alan salt okunurdur. Görünümü destekleyen DOM Öğesi.
locationBias optional
Tür:  LocationBias optional
Yer ararken kullanılacak yumuşak bir sınır veya ipucu.
locationRestriction optional
Tür:  LocationRestriction optional
Arama sonuçlarını sınırlandırmak için sınırlar.
requestedLanguage optional
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.
requestedRegion optional
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).
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.

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.