Places Autocomplete Service

AutocompleteService sınıfı

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

Otomatik tamamlama tahminlerini almayla ilgili yöntemleri içerir.

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

AutocompleteService
AutocompleteService()
Parametreler: Yok
AutocompleteService için yeni bir örnek oluşturur.
getPlacePredictions
getPlacePredictions(request[, callback])
Parametreler: 
Döndürülen Değer:  Promise<AutocompleteResponse>
Sağlanan otomatik tamamlama isteğine göre yer otomatik tamamlama tahminlerini alır.
getQueryPredictions
getQueryPredictions(request, callback)
Parametreler: 
Döndürülen Değer: Yok
Sağlanan sorgu otomatik tamamlama isteğine göre sorgu otomatik tamamlama tahminlerini alır.

AutocompletionRequest arabirim

google.maps.places.AutocompletionRequest arayüz

AutocompleteService.getPlacePredictions adresine gönderilecek otomatik tamamlama isteği.

input
Tür:  string
Kullanıcı tarafından girilen giriş dizesi.
bounds optional
Tahmin önyargısı için sınırlar. Tahminler, verilen bounds değerine göre verilir ancak bu değerle sınırlı değildir. bounds ayarlanırsa hem location hem de radius yoksayılır.
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.
language 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 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.
location optional
Tür:  LatLng optional
Tahmin önyargısı için konum. Tahminler, belirtilen location ve radius değerlerine göre yapılır. Alternatif olarak bounds de kullanılabilir.
locationBias optional
Tür:  LocationBias optional
Yer araması yaparken kullanılacak yumuşak sınır veya ipucu.
locationRestriction optional
Tür:  LocationRestriction optional
Arama sonuçlarını sınırlayacak aralıklar.
offset optional
Tür:  number optional
Hizmetin tahminler için metin kullandığı giriş terimindeki karakter konumu (imlecin giriş alanındaki konumu).
origin optional
Tür:  LatLng|LatLngLiteral optional
AutocompletePrediction.distance_meters değerinin hesaplandığı konum.
radius optional
Tür:  number optional
Tahmin önyargısı için kullanılan alanın yarıçapı. radius, metre cinsinden belirtilir ve her zaman bir location mülkü ile birlikte kullanılmalıdır. Alternatif olarak bounds de kullanılabilir.
region optional
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).
sessionToken optional
Tür:  AutocompleteSessionToken optional
Tekil istekleri oturumlara gruplandırmak için kullanılan benzersiz referans.
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.

AutocompleteResponse arabirim

google.maps.places.AutocompleteResponse arayüz

AutocompleteService.getPlacePredictions çağrısı tarafından döndürülen ve AutocompletePrediction öğelerinin listesini içeren bir otomatik tamamlama yanıtı.

predictions
AutocompletePrediction değerlerinin listesi.

QueryAutocompletionRequest sınıfı

google.maps.places.QueryAutocompletionRequest arayüz

QueryAutocompleteService adresine gönderilecek bir QueryAutocompletion isteği.

input
Tür:  string
Kullanıcı tarafından girilen giriş dizesi.
bounds optional
Tahmin önyargısı için sınırlar. Tahminler, verilen bounds değerine göre verilir ancak bu değerle sınırlı değildir. bounds ayarlanırsa hem location hem de radius yoksayılır.
location optional
Tür:  LatLng optional
Tahmin önyargısı için konum. Tahminler, belirtilen location ve radius değerlerine göre yapılır. Alternatif olarak bounds de kullanılabilir.
offset optional
Tür:  number optional
Hizmetin tahminler için metin kullandığı giriş terimindeki karakter konumu (imlecin giriş alanındaki konumu).
radius optional
Tür:  number optional
Tahmin önyargısı için kullanılan alanın yarıçapı. radius, metre cinsinden belirtilir ve her zaman bir location mülkü ile birlikte kullanılmalıdır. Alternatif olarak bounds de kullanılabilir.

ComponentRestrictions arabirimi

google.maps.places.ComponentRestrictions arayüz

Otomatik tamamlama hizmetiyle kullanılabilecek bileşen kısıtlamalarını tanımlar.

country optional
Tür:  string|Array<string> optional
Tahminleri belirtilen ülkeyle (ISO 3166-1 Alpha-2 ülke kodu, büyük/küçük harf duyarlı değildir) kısıtlar. Örneğin, 'us', 'br' veya 'au'. Tek bir ülke kodu veya en fazla beş ülke kodu dizesi dizisi sağlayabilirsiniz.

AutocompletePrediction arabirim

google.maps.places.AutocompletePrediction arayüz

Tek bir otomatik tamamlama tahminini temsil eder.

description
Tür:  string
Bu, Yerler hizmeti tarafından önerilen sorgunun biçimlendirilmemiş sürümüdür.
matched_substrings
Yerin açıklamasında, kullanıcının girişindeki öğelerle eşleşen ve bu alt dizelerin vurgulanmasında kullanılmaya uygun bir alt dize grubu. Her alt dize, Unicode karakterleriyle ifade edilen bir ofset ve uzunlukla tanımlanır.
place_id
Tür:  string
Yer ayrıntıları hizmetini kullanarak bu yerle ilgili ayrıntıları almak için kullanılabilecek bir yer kimliği (PlacesService.getDetails bölümüne bakın).
structured_formatting
Yerin açıklamasıyla ilgili yapılandırılmış bilgiler. Ana metin ve ikincil metin olarak ayrılır. Otomatik tamamlama girişindeki eşleşen alt dize dizisi de bu bilgilere dahildir. Bu dize dizisi, bir ofset ve uzunlukla tanımlanır ve Unicode karakterleriyle ifade edilir.
terms
Yukarıdaki açıklamadaki terimlerle ilgili bilgiler (en spesifikten en az spesifik olana doğru). Örneğin, "Taco Bell", "Willitis" ve "CA".
types
Tür:  Array<string>
Tahminin ait olduğu tür dizisi (ör. 'establishment' veya 'geocode').
distance_meters optional
Tür:  number optional
Yerin AutocompletionRequest.origin'e olan mesafesi (metre cinsinden).

QueryAutocompletePrediction arabirim

google.maps.places.QueryAutocompletePrediction arayüz

Tek bir sorgu otomatik tamamlama tahminini temsil eder.

description
Tür:  string
Bu, Yerler hizmeti tarafından önerilen sorgunun biçimlendirilmemiş sürümüdür.
matched_substrings
Yerin açıklamasında, kullanıcının girişindeki öğelerle eşleşen ve bu alt dizelerin vurgulanmasında kullanılmaya uygun bir alt dize grubu. Her alt dize, Unicode karakterleriyle ifade edilen bir ofset ve uzunlukla tanımlanır.
terms
Yukarıdaki açıklamadaki terimlerle ilgili bilgiler. Kategorik terimler önce gelir (ör. "restoran"). Adres terimleri en spesifikten en az spesifik olana doğru görünür. Örneğin, "San Francisco" ve "CA".
place_id optional
Tür:  string optional
Yalnızca tahmin bir yer ise kullanılabilir. Yer ayrıntıları hizmetini kullanarak bu yerle ilgili ayrıntıları almak için kullanılabilecek bir yer kimliği (PlacesService.getDetails bölümüne bakın).

PredictionTerm arayüzü

google.maps.places.PredictionTerm arayüz

Bir tahmin terimini temsil eder.

offset
Tür:  number
Yerin açıklamasında bu terimin başlangıcının unicode karakterleri cinsinden ofseti.
value
Tür:  string
Bu terimin değeri (ör. "Taco Bell").

PredictionSubstring arayüzü

google.maps.places.PredictionSubstring arayüz

Bir tahmin alt dizesini temsil eder.

length
Tür:  number
Alt dizenin uzunluğu.
offset
Tür:  number
Alt dizenin açıklama dizesi içindeki başlangıç ofseti.

StructuredFormatting arayüzü

google.maps.places.StructuredFormatting arayüz

Yerin açıklamasıyla ilgili yapılandırılmış bilgileri içerir. Bu bilgiler, ana metin ve ikincil metin olarak ayrılır. Ana metin, Unicode karakterleriyle ifade edilen bir ofset ve uzunlukla tanımlanan, otomatik tamamlama girişindeki eşleşen alt dizelerden oluşan bir dizi içerir.

main_text
Tür:  string
Bu, Yerler hizmeti tarafından önerilen yerin biçimlendirilmemiş açıklamasının ana metin kısmıdır. Genellikle yerin adıdır.
main_text_matched_substrings
Ana metinde, kullanıcının girişindeki öğelerle eşleşen ve bu alt dizelerin vurgulanmasında kullanılmaya uygun bir alt dize grubu. Her alt dize, Unicode karakterleriyle ifade edilen bir ofset ve uzunlukla tanımlanır.
secondary_text
Tür:  string
Bu, Yerler hizmeti tarafından önerilen yerin biçimlendirilmemiş açıklamasının ikincil metin kısmıdır. Genellikle yerin konumu.