Places Widgets

PlaceAutocompleteElement sınıfı

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

PlaceAutocompleteElement, Places Autocomplete API için 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 HTMLElement sınıfını genişletir.

Bu sınıf PlaceAutocompleteElementOptions sınıfını uygular.

const {PlaceAutocompleteElement} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişebilirsiniz. Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
Parametreler: 
componentRestrictions
Tür:  ComponentRestrictions optional
Bileşen kısıtlamaları. Bileşen kısıtlamaları, tahminleri yalnızca üst bileşendekilerle kısıtlamak için kullanılır. Örneğin, ülke.
locationBias
Tür:  LocationBias optional
Yer araması yaparken kullanılacak yumuşak sınır veya ipucu.
locationRestriction
Tür:  LocationRestriction optional
Arama sonuçlarını sınırlayacak aralıklar.
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 adresine bakın. Girişler için ad özelliğiyle aynı davranışı izler. Bu, form gönderilirken kullanılacak addır. Ayrıntılar için https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form adresine bakın.
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 dilde sonuçlara daha yüksek bir sıralama verilebilir ancak öneriler bu dil ile 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. Bu, önerileri bu ülkeyle sınırlamaz. Bölge kodu, iki karakterli bir ccTLD ("üst düzey alan") değerini kabul eder. Bazı önemli istisnalar dışında, çoğu ccTLD kodu ISO 3166-1 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk) iken ISO 3166-1 kodu "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" tüzel kişiliği için).
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
Tahminler açılır menüsünde tek bir tahmini temsil eden bir öğe.
prediction-item-icon
Tahminler listesindeki her öğenin solunda gösterilen simge.
prediction-item-main-text
Tahminin ana metni olan prediction-item öğesinin bir parçası. Coğrafi konumlar için bu alan, "Sydney" gibi bir yer adı veya "10 King Street" gibi bir sokak adı ve numarası içerir. prediction-item-main-text varsayılan olarak siyah renklidir. prediction-item öğesinde ek metin varsa bu metin, prediction-item-main-text öğesinin dışındadır ve stilini prediction-item öğesinden devralır. Varsayılan olarak gri renklidir. Ek metin genellikle bir adrestir.
prediction-item-match
Döndürülen tahminin, kullanıcının girişiyle eşleşen kısmı. Varsayılan olarak bu eşleşen metin kalın olarak vurgulanır. Eşleşen metnin, prediction-item içinde herhangi bir yerde olabileceğini unutmayın. prediction-item-main-text öğesinin parçası olmayabilir.
prediction-item-selected
Kullanıcı klavyeyle bu öğeye gittiğinde öğe. Not: Seçilen öğeler hem bu bölüm stillerinden hem de tahmin öğesi bölüm stillerinden etkilenir.
prediction-list
Yer Otomatik Tamamlama hizmeti tarafından döndürülen tahminlerin listesini içeren görsel öğe. Bu liste, PlaceAutocompleteElement'in altında 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 harf 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çeneklere bakın. Özel etkinlikler yalnızca capture ve passive'i destekler.
Döndürülen Değer:  void
Belirtilen etkinlik hedefe her sunulduğunda çağrılacak bir işlev oluşturur. addEventListener konusuna bakın
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametreler: 
Döndürülen Değer:  void
Daha önce addEventListener ile kaydedilen bir etkinlik işleyiciyi hedeften kaldırır. removeEventListener işlevine bakın.
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 uçtan gelen bir istek reddedildiğinde (ör. yanlış API anahtarı) tetiklenir. Bu etkinlik üst öğeye iletilmez.

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ı yer otomatik tamamlama öğesini kullanarak bir yer seçtikten sonra oluşturulur. event.place ile seçime erişin.

Bu sınıf Event sınıfını genişletir.

const {PlaceAutocompletePlaceSelectEvent} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişebilirsiniz. Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
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 Event sınıfını genişletir.

const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişebilirsiniz. Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

Otomatik Tamamlama sınıfı

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

Kullanıcının metin girişine göre yer tahminleri sağlayan bir widget. text türündeki bir giriş öğesine eklenir ve söz konusu alandaki metin girişini dinler. Tahminlerin listesi açılır liste olarak sunulur ve metin girildiğinde güncellenir.

Bu sınıf MVCObject sınıfını genişletir.

const {Autocomplete} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişebilirsiniz. Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
Autocomplete
Autocomplete(inputField[, opts])
Parametreler: 
Belirtilen seçeneklerle belirtilen giriş metin alanına eklenen yeni bir Autocomplete örneği oluşturur.
getBounds
getBounds()
Parametreler: Yok
Döndürülen Değer:  LatLngBounds|undefined Eğilimli sınırlar.
Tahminlerin önyargılı olduğu sınırları döndürür.
getFields
getFields()
Parametreler: Yok
Döndürülen Değer:  Array<string>|undefined
Ayrıntılar başarıyla alındığında, yer için ayrıntılar yanıtına eklenecek alanları döndürür. Alanların listesi için PlaceResult bölümüne bakın.
getPlace
getPlace()
Parametreler: Yok
Döndürülen Değer:  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 mülkü giriş alanının mevcut değerine ayarlanmış bir Place taslağı nesnesi döndürür.
setBounds
setBounds(bounds)
Parametreler: 
Döndürülen Değer: Yok
Yer sonuçlarının döndürüleceği tercih edilen alanı belirler. Sonuçlar bu bölgeye yöneliktir ancak bu bölgeyle sınırlı değildir.
setComponentRestrictions
setComponentRestrictions(restrictions)
Parametreler: 
Döndürülen Değer: Yok
Bileşen kısıtlamalarını ayarlar. Bileşen kısıtlamaları, tahminleri yalnızca üst bileşendekilerle kısıtlamak için kullanılır. Örneğin, ülke.
setFields
setFields(fields)
Parametreler: 
  • fields:  Array<string> optional
Döndürülen Değer: Yok
Ayrıntılar başarıyla alındığında yer için ayrıntılar yanıtına dahil edilecek alanları ayarlar. Alanların listesi için PlaceResult bölümüne bakın.
setOptions
setOptions(options)
Parametreler: 
Döndürülen Değer: Yok
setTypes
setTypes(types)
Parametreler: 
  • types:  Array<string> optional Dahil edilecek tahmin türleri.
Döndürülen Değer: Yok
Döndürülecek tahmin türlerini belirler. 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 PlaceResult kullanıma sunulduğunda tetiklenir.
Kullanıcı, kontrol tarafından önerilmeyen bir yerin adını girip Enter tuşuna basarsa veya bir Yer Ayrıntıları isteği başarısız olursa PlaceResult, name mülkünde kullanıcı girişini içerir ve başka mülk tanımlanmaz.

AutocompleteOptions arabirim

google.maps.places.AutocompleteOptions arayüz

Autocomplete nesnesinde ayarlanabilen seçenekler.
bounds optional
Yer aranacak alan.
componentRestrictions optional
Tür:  ComponentRestrictions optional
Bileşen kısıtlamaları. Bileşen kısıtlamaları, tahminleri yalnızca üst bileşendekilerle 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 ayrıntılar yanıtında yer için eklenecek alanlar (bunlar için faturalandırılır). ['ALL'] iletilirse mevcut tüm alanlar döndürülür ve faturalandırılır (bu, üretim dağıtımları için önerilmez). Alanların listesi için PlaceResult bölümüne bakın. İç içe yerleştirilmiş alanlar noktalı yollarla (örneğin, "geometry.location") belirtilebilir. Varsayılan değer ['ALL']'dur.
placeIdOnly optional
Tür:  boolean optional
Yalnızca yer kimliklerinin mi alınacağını belirtir. place_changed etkinliği tetiklendiğinde kullanıma sunulan PlaceResult yalnızca place_id, types ve name alanlarına sahiptir. Bu alanlara, Otomatik Tamamlama hizmeti tarafından döndürülen place_id, types ve description değerleri eklenir. 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 olan yerleri döndürmesi gerektiğini belirten bir boole değeri. strictBounds parametresini false (varsayılan değer) olarak ayarlamak, sonuçların sınırların içinde bulunan yerlere doğru yanlı olmasına neden olur ancak sonuçların sınırların içinde bulunan yerlerle sınırlı olmasını sağlamaz.
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

Kullanıcının metin girişine göre sorgu tahminleri sağlayan bir widget. text türündeki bir giriş öğesine eklenir ve söz konusu alandaki metin girişini dinler. Tahminlerin listesi açılır liste olarak sunulur ve metin girildiğinde güncellenir.

Bu sınıf MVCObject sınıfını genişletir.

const {SearchBox} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişebilirsiniz. Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
SearchBox
SearchBox(inputField[, opts])
Parametreler: 
Belirtilen seçeneklerle belirtilen giriş metin alanına eklenen yeni bir SearchBox örneği oluşturur.
getBounds
getBounds()
Parametreler: Yok
Döndürülen Değer:  LatLngBounds|undefined
Sorgu tahminlerinin önyargılı olduğu sınırları döndürür.
getPlaces
getPlaces()
Parametreler: Yok
Döndürülen Değer:  Array<PlaceResult>|undefined
Kullanıcı tarafından places_changed etkinliğiyle birlikte kullanılmak üzere seçilen sorguyu döndürür.
setBounds
setBounds(bounds)
Parametreler: 
Döndürülen Değer: Yok
Sorgu tahminlerini önyargılı hale getirmek için kullanılacak bölgeyi ayarlar. Sonuçlar yalnızca bu alana yöneliktir ve tamamen bu alanla sınırlı değildir.
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

SearchBox nesnesinde ayarlanabilen seçenekler.
bounds optional
Sorgu tahminlerinin önyargılı olacağı alan. Tahminler bu sınırları hedefleyen sorgulara yöneliktir ancak bunlarla sınırlı değildir.