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: 
  • typestring Dinlenecek etkinlik türünü temsil eden, büyük/küçük harf duyarlı bir dize.
  • listenerEventListener|EventListenerObject Bildirim alan nesne. Bu, handleEvent yöntemine sahip bir işlev veya nesne olmalıdır.
  • optionsboolean|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
locationBias optional
Tür:  LocationBias optional
locationRestriction optional
Tür:  LocationRestriction optional
requestedLanguage optional
Tür:  string optional
requestedRegion optional
Tür:  string optional
types optional
Tür:  Array<string> optional

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.

PlaceDetailsElement sınıfı

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

Bir yerin ayrıntılarını gösteren HTML öğesi. Oluşturulacak içeriği belirtmek için configureFromPlace() veya configureFromLocation() yöntemlerini kullanın. Yer Ayrıntıları Öğesi'ni kullanmak için Google Cloud Console'da projeniz için Places UI Kit API'yi etkinleştirin.

Özel öğe:
<gmp-place-details size="small"></gmp-place-details>

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

Bu sınıf PlaceDetailsElementOptions sınıfını uygular.

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

PlaceDetailsElement
PlaceDetailsElement([options])
Parametreler: 
place
Tür:  Place optional
Salt okunur. Şu anda oluşturulmakta olan yerin kimliğini, konumunu ve görüntü alanını içeren Place nesnesi.
size
Tür:  PlaceDetailsSize optional
PlaceDetailsElement öğesinin boyut varyantı. Öğe varsayılan olarak PlaceDetailsSize.X_LARGE değerini gösterir.
HTML özelliği:
  • <gmp-place-details size="small"></gmp-place-details>
  • <gmp-place-details size="medium"></gmp-place-details>
  • <gmp-place-details size="large"></gmp-place-details>
  • <gmp-place-details size="x-large"></gmp-place-details>
BetaaddEventListener
addEventListener(type, listener[, options])
Parametreler: 
  • typestring Dinlenecek etkinlik türünü temsil eden, büyük/küçük harf duyarlı bir dize.
  • listenerEventListener|EventListenerObject Bildirim alan nesne. Bu, handleEvent yöntemine sahip bir işlev veya nesne olmalıdır.
  • optionsboolean|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
configureFromLocation
configureFromLocation(location)
Parametreler: 
Döndürülen Değer:  Promise<void> Yer verileri yüklendikten ve oluşturulduktan sonra çözülen bir söz.
Tersine coğrafi kodlama kullanarak widget'ı bir LatLng'ten yapılandırır.
configureFromPlace
configureFromPlace(place)
Parametreler: 
  • placePlace|{id:string} Ayrıntıların oluşturulacağı yer.
Döndürülen Değer:  Promise<void> Yer verileri yüklendikten ve oluşturulduktan sonra çözülen bir söz.
Widget'ı bir Place nesnesinden veya yer kimliğinden yapılandırır.
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-load
function(event)
Bağımsız değişkenler: 
Bu etkinlik, öğe yüklendiğinde ve içeriğini oluşturduğunda tetiklenir. Bu etkinlik üst öğeye iletilmez.
gmp-requesterror
function(event)
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.

PlaceDetailsElementOptions arabirim

google.maps.places.PlaceDetailsElementOptions arayüz

PlaceDetailsElement için seçenekler.

size optional
Tür:  PlaceDetailsSize optional

PlaceDetailsSize constants

google.maps.places.PlaceDetailsSize constants

PlaceDetailsElement için boyut varyantları.

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

LARGE Büyük resim, temel bilgiler ve iletişim bilgileri içeren büyük varyant.
MEDIUM Büyük resim ve temel bilgiler içeren orta varyant.
SMALL Küçük bir resim ve temel bilgiler içeren küçük varyant.
X_LARGE Fotoğraf kolajının, yorumların ve kapsamlı yer bilgilerinin yer aldığı ekstra büyük varyant.

PlaceListElement sınıfı

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

Bir yer aramasının sonuçlarını listede gösteren HTML öğesi. Sonuçları oluşturma isteğini belirtmek için configureFromSearchByTextRequest() veya configureFromSearchNearbyRequest() yöntemlerini kullanın. Yer listesi öğesini kullanmak için Google Cloud Console'da projeniz için Places UI Kit API'yi etkinleştirin.

Özel öğe:
<gmp-place-list selectable></gmp-place-list>

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

Bu sınıf PlaceListElementOptions sınıfını uygular.

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

PlaceListElement
PlaceListElement([options])
Parametreler: 
places
Tür:  Array<Place>
Salt okunur. Şu anda oluşturulmakta olan yerlerin kimliklerini, konumlarını ve görüntü alanlarını içeren Place nesnesi dizisi.
selectable
Tür:  boolean
Liste öğelerinin seçilebilir olup olmadığı. Doğru ise liste öğeleri, tıklandığında gmp-placeselect etkinliğini gönderen düğmeler olur. Erişilebilir klavye gezinme ve seçim de desteklenir.
HTML özelliği:
  • <gmp-place-list selectable></gmp-place-list>
BetaaddEventListener
addEventListener(type, listener[, options])
Parametreler: 
  • typestring Dinlenecek etkinlik türünü temsil eden, büyük/küçük harf duyarlı bir dize.
  • listenerEventListener|EventListenerObject Bildirim alan nesne. Bu, handleEvent yöntemine sahip bir işlev veya nesne olmalıdır.
  • optionsboolean|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
configureFromSearchByTextRequest
configureFromSearchByTextRequest(request)
Parametreler: 
  • requestSearchByTextRequest Sonuçların oluşturulması istenen öğe. SearchByTextRequest mülkü için fields özelliği gerekli değildir.
Döndürülen Değer:  Promise<void> Yer verileri yüklendikten ve oluşturulduktan sonra çözülen bir söz.
Widget'ı, bir Places Text Search API isteğinden arama sonuçlarını oluşturacak şekilde yapılandırır.
configureFromSearchNearbyRequest
configureFromSearchNearbyRequest(request)
Parametreler: 
  • requestSearchNearbyRequest Sonuçların oluşturulması istenen öğe. SearchNearbyRequest mülkü için fields özelliği gerekli değildir.
Döndürülen Değer:  Promise<void> Yer verileri yüklendikten ve oluşturulduktan sonra çözülen bir söz.
Widget'ı, Places Nearby Search API isteğinde arama sonuçlarını oluşturacak şekilde yapılandırır.
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-load
function(event)
Bağımsız değişkenler: 
Bu etkinlik, öğe yüklendiğinde ve içeriğini oluşturduğunda tetiklenir. Bu etkinlik üst öğeye iletilmez.
gmp-placeselect
function(event)
Bağımsız değişkenler: 
Bu etkinlik, kullanıcı bir yer seçtiğinde tetiklenir. Bir Place nesnesi ve listedeki seçili yerin dizin numarasını içerir.
gmp-requesterror
function(event)
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.

PlaceListElementOptions arayüzü

google.maps.places.PlaceListElementOptions arayüz

PlaceListElement için seçenekler.

selectable optional
Tür:  boolean optional

PlaceListPlaceSelectEvent sınıfı

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

Bu etkinlik, kullanıcı bir yer seçtiğinde PlaceListElement tarafından yayınlanır.

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

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

index
Tür:  number
Seçilen yerin liste dizini.
place
Tür:  Place
Seçilen yerin kimliğini, konumunu ve görüntü alanını içeren bir Place nesnesi.

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: 
  • fieldsArray<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: 
  • typesArray<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.