Places Widgets

PlaceAutocompleteElement sınıfı

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

Yerler için Otomatik Tamamlama Görünümü API'si

Bu sınıf PlaceAutocompleteElementOptions uyguluyor.

const {PlaceAutocompleteElement} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki kitaplıklar başlıklı bölümü inceleyin.

PlaceAutocompleteElement
PlaceAutocompleteElement(options)
Parametreler: 
element optional
Tür:  HTMLElement|SVGElement optional
Bu alan salt okunur durumdadır. Görünümü destekleyen DOM Öğesi.
inputElement
Otomatik tamamlamaları gösteren giriş öğesi.
Devralındı: componentRestrictions, locationBias, locationRestriction, requestedLanguage, requestedRegion, types
addListener
addListener(eventName, handler)
Parametreler: 
  • eventNamestring
  • handlerFunction
İade Değeri:  MapsEventListener
Belirtilen dinleyici işlevini belirtilen 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 uç isteği reddedildiğinde tetiklenir (ör. yanlış API anahtarı). Bu etkinlik baloncuk değil.

PlaceAutocompleteElementOptions arayüz

google.maps.places.PlaceAutocompleteElementOptions arayüz

PlaceAutocompleteElement oluşturma seçenekleri.

inputElement
Otomatik tamamlamaları gösteren giriş öğesi.
componentRestrictions optional
Tür:  ComponentRestrictions optional
Bileşen kısıtlamaları. Bileşen kısıtlamaları, tahminleri yalnızca üst bileşendeki tahminlerle kısıtlamak için kullanılır. Örneğin, ülke.
element optional
Tür:  HTMLElement|SVGElement optional
Bu alan salt okunur durumdadır. Görünümü destekleyen DOM Öğesi.
locationBias optional
Tür:  LocationBias optional
Yer ararken kullanabileceğiniz yumuşak bir sınır veya ipucu.
locationRestriction optional
Tür:  LocationRestriction optional
Arama sonuçlarını kısıtlamak için kullanılan sınırlar.
requestedLanguage optional
Tür:  string optional
Mümkünse sonuçların döndürülmesi gereken dil için bir 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çimlendirmesi ve sonuç filtrelemesi için kullanılan bir bölge kodu. Önerilerin kısıtlanmaması için bu ülke kullanılır. Bölge kodu, iki karakterli 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), ISO 3166-1 kodu ise "gb"dır (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" için).
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. Tür belirtilmezse tüm türler döndürülür.

Otomatik tamamlama sınıfı

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

Kullanıcının metin girişine dayalı Yer tahminleri sağlayan bir widget. text türündeki bir giriş öğesine iliştirilir ve o alandaki metin girişini dinler. Tahmin listesi, açılır liste olarak sunulur ve metin girildikçe güncellenir.

Bu sınıf MVCObject tarihinde uzatılır.

const {Autocomplete} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki kitaplıklar başlıklı bölümü inceleyin.

Autocomplete
Autocomplete(inputField[, opts])
Parametreler: 
Belirtilen seçeneklerle belirtilen giriş metni alanına eklenen yeni bir Autocomplete örneği oluşturur.
getBounds
getBounds()
Parametreler: Yok
İade Değeri:  LatLngBounds|undefined Taraflı seçim sınırları.
Tahminlerin taraflı olduğu sınırları döndürür.
getFields
getFields()
Parametreler: Yok
İade Değeri:  Array<string>|undefined
Ayrıntılar başarılı bir şekilde alındığında ayrıntılar yanıtında Yer için dahil edilecek alanları döndürür. Alanların listesi için PlaceResult adresini ziyaret edin.
getPlace
getPlace()
Parametreler: Yok
İade Değeri:  PlaceResult Kullanıcı tarafından seçilen yer.
Ayrıntılar başarıyla 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 mevcut değerine ayarlanmış bir saplama Yer nesnesi döndürür.
setBounds
setBounds(bounds)
Parametreler: 
Return Value: Yok
Yer sonuçlarının döndürülmesi için tercih edilen alanı ayarlar. Sonuçlar, bu alana yönelik olup yalnızca bunlarla 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şendeki tahminlerle kısıtlamak için kullanılır. Örneğin, ülke.
setFields
setFields(fields)
Parametreler: 
  • fieldsArray<string> optional
Return Value: Yok
Ayrıntılar başarıyla alındığında ayrıntılara yanıtta Yer için dahil edilecek alanları ayarlar. Alanların listesi için PlaceResult adresini ziyaret edin.
setOptions
setOptions(options)
Parametreler: 
Return Value: Yok
setTypes
setTypes(types)
Parametreler: 
  • typesArray<string> optional Eklenecek 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. 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ı seçtiği bir yer için PlaceResult kullanıma sunulduğunda tetiklenir.
Kullanıcı, kontrol tarafından önerilmeyen bir yerin adını girer ve Enter tuşuna basarsa veya bir Yer Ayrıntıları isteği başarısız olursa name, başka herhangi bir özellik tanımlanmadan name özelliğinde kullanıcı girişini içerir.

AutocompleteOptions arayüzü

google.maps.places.AutocompleteOptions arayüz

Autocomplete nesnesi üzerinde ayarlanabilecek 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şendeki tahminlerle kısıtlamak için kullanılır. Örneğin, ülke.
fields optional
Tür:  Array<string> optional
Ayrıntılar başarılı bir şekilde alındığında yer yanıtına dahil edilecek alanlar dolayısıyla faturalandırılacaktır. ['ALL'] aktarılırsa kullanılabilir tüm alanlar döndürülür ve bunlar için faturalandırılırsınız (üretim dağıtımları için önerilmez). Alanların listesi için PlaceResult adresini ziyaret edin. İç içe geçmiş alanlar nokta yolları ile belirtilebilir (örneğin, "geometry.location"). Varsayılan değer: ['ALL'].
placeIdOnly optional
Tür:  boolean optional
Yalnızca Yer Kimlikleri alınıp alınmayacağı. Place_changed etkinliği tetiklendiğinde sunulan PlaceResult yalnızca otomatik yer hizmeti tarafından döndürülen Place_id, türler ve ad alanlarının yanı sıra Place_id, türler ve açıklama içerir. Varsayılan olarak devre dışıdır.
strictBounds optional
Tür:  boolean optional
Otomatik tamamlama widget'ının yalnızca sorgu gönderilirken Otomatik tamamlama widget'ının sınırları içinde olan yerleri döndürmesi gerektiğini gösteren bir boole değeri. strictBound'ları false (varsayılan) olarak ayarlamak, sonuçların sınırlar içinde bulunan yerlere yönelik olmasına karşın bunlarla sınırlı kalmamasını sağlar.
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. Tür belirtilmezse tüm türler döndürülür.

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

Kullanıcının metin girişine dayalı sorgu tahminleri sağlayan bir widget. text türündeki bir giriş öğesine iliştirilir ve o alandaki metin girişini dinler. Tahmin listesi, açılır liste olarak sunulur ve metin girildikçe güncellenir.

Bu sınıf MVCObject tarihinde uzatılır.

const {SearchBox} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki kitaplıklar başlıklı bölümü inceleyin.

SearchBox
SearchBox(inputField[, opts])
Parametreler: 
Belirtilen seçeneklerle belirtilen giriş metni alanına eklenen yeni bir SearchBox örneği oluşturur.
getBounds
getBounds()
Parametreler: Yok
İade Değeri:  LatLngBounds|undefined
Sorgu tahminlerinin eğilimli olduğu sınırları döndürür.
getPlaces
getPlaces()
Parametreler: Yok
İade Değeri:  Array<PlaceResult>|undefined
places_changed etkinliğiyle kullanılacak kullanıcı tarafından seçilen sorguyu döndürür.
setBounds
setBounds(bounds)
Parametreler: 
Return Value: Yok
Bölgeyi sorgulama tahminleri için kullanılacak bölgeyi belirler. Sonuçlar yalnızca bu alana göre eğilimli olur ve yalnızca 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 ve getPlaces yeni yerler almak için kullanılmalıdır.

SearchBoxOptions arayüz

google.maps.places.SearchBoxOptions arayüz

SearchBox nesnesi üzerinde ayarlanabilecek seçenekler.

bounds optional
Sorgu tahminlerine sapma yapılacak alan. Tahminler bu sınırları hedefleyen sorgulara göre uyarlanır ancak bunlarla sınırlı değildir.