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.
Marka | |
|---|---|
AutocompleteService |
AutocompleteService()Parametreler: Yok
AutocompleteService için yeni bir örnek oluşturur. |
Yöntemler | |
|---|---|
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.
Özellikler | |
|---|---|
input |
Tür:
stringKullanıcı tarafından girilen giriş dizesi. |
|
Tür:
LatLngBounds|LatLngBoundsLiteral optionalTahmin ö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 optionalBileş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 optionalMü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. |
|
Tür:
LatLng optionalTahmin ö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 optionalYer araması yaparken kullanılacak yumuşak sınır veya ipucu. |
locationRestriction optional |
Tür:
LocationRestriction optionalArama sonuçlarını sınırlayacak aralıklar. |
offset optional |
Tür:
number optionalHizmetin tahminler için metin kullandığı giriş terimindeki karakter konumu (imlecin giriş alanındaki konumu). |
origin optional |
Tür:
LatLng|LatLngLiteral optionalAutocompletePrediction.distance_meters değerinin hesaplandığı konum. |
|
Tür:
number optionalTahmin ö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 optionalSonuç 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 optionalTekil istekleri oturumlara gruplandırmak için kullanılan benzersiz referans. |
types optional |
Tür:
Array<string> optionalDö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ı.
Özellikler | |
|---|---|
predictions |
Tür:
Array<AutocompletePrediction>AutocompletePrediction değerlerinin listesi. |
QueryAutocompletionRequest sınıfı
google.maps.places.QueryAutocompletionRequest
arayüz
QueryAutocompleteService adresine gönderilecek bir QueryAutocompletion isteği.
Özellikler | |
|---|---|
input |
Tür:
stringKullanıcı tarafından girilen giriş dizesi. |
bounds optional |
Tür:
LatLngBounds|LatLngBoundsLiteral optionalTahmin ö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 optionalTahmin ö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 optionalHizmetin tahminler için metin kullandığı giriş terimindeki karakter konumu (imlecin giriş alanındaki konumu). |
radius optional |
Tür:
number optionalTahmin ö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.
Özellikler | |
|---|---|
country optional |
Tür:
string|Array<string> optionalTahminleri 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.
Özellikler | |
|---|---|
description |
Tür:
stringBu, Yerler hizmeti tarafından önerilen sorgunun biçimlendirilmemiş sürümüdür. |
matched_substrings |
Tür:
Array<PredictionSubstring>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:
stringYer 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 |
Tür:
StructuredFormattingYerin 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 |
Tür:
Array<PredictionTerm>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 optionalYerin AutocompletionRequest.origin'e olan mesafesi (metre cinsinden). |
QueryAutocompletePrediction arabirim
google.maps.places.QueryAutocompletePrediction
arayüz
Tek bir sorgu otomatik tamamlama tahminini temsil eder.
Özellikler | |
|---|---|
description |
Tür:
stringBu, Yerler hizmeti tarafından önerilen sorgunun biçimlendirilmemiş sürümüdür. |
matched_substrings |
Tür:
Array<PredictionSubstring>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 |
Tür:
Array<PredictionTerm>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 optionalYalnı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.
Özellikler | |
|---|---|
offset |
Tür:
numberYerin açıklamasında bu terimin başlangıcının unicode karakterleri cinsinden ofseti. |
value |
Tür:
stringBu terimin değeri (ör. "Taco Bell"). |
PredictionSubstring arayüzü
google.maps.places.PredictionSubstring
arayüz
Bir tahmin alt dizesini temsil eder.
Özellikler | |
|---|---|
length |
Tür:
numberAlt dizenin uzunluğu. |
offset |
Tür:
numberAlt 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.
Özellikler | |
|---|---|
main_text |
Tür:
stringBu, 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 |
Tür:
Array<PredictionSubstring>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:
stringBu, Yerler hizmeti tarafından önerilen yerin biçimlendirilmemiş açıklamasının ikincil metin kısmıdır. Genellikle yerin konumu. |