AutocompleteService sınıfı
google.maps.places.AutocompleteService
sınıf
Otomatik tamamlama tahminlerini alma ile 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 öğesinin yeni bir örneğini oluşturur. |
Yöntemler | |
|---|---|
getPlacePredictions |
getPlacePredictions(request[, callback])Parametreler:
İade Değeri:
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 arayüzü
google.maps.places.AutocompletionRequest
arayüz
AutocompleteService.getPlacePredictions adresine gönderilecek bir otomatik tamamlama isteği.
Özellikler | |
|---|---|
input |
Tür:
stringKullanıcı giriş dizesini girdi. |
|
Tür:
LatLngBounds|LatLngBoundsLiteral optionalTahmin önyargısı için sınırlar. Tahminler, belirtilen bounds öğesine yönelik olarak yanlı olacak ancak bununla sınırlı olmayacaktır. 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şendeki tahminlerle sınırlamak 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 bir dil tanımlayıcısı. Seçilen dildeki sonuçlar daha yüksek bir sıralama alabilir ancak öneriler bu dille 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 şekillenecektir. Alternatif olarak bounds kullanılabilir. |
locationBias optional |
Tür:
LocationBias optionalYer ararken kullanılacak yumuşak bir sınır veya ipucu. |
locationRestriction optional |
Tür:
LocationRestriction optionalArama sonuçlarını sınırlamak için kullanılan sınırlar. |
offset optional |
Tür:
number optionalHizmetin tahminler için metin kullandığı giriş terimindeki karakter konumu (giriş alanındaki imlecin 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 özelliğiyle birlikte verilmelidir. Alternatif olarak bounds kullanılabilir. |
region optional |
Tür:
string optionalSonuç biçimlendirmesi ve sonuç filtreleme için kullanılan bir bölge kodu. Öneriler bu ülke ile sınırlı değildir. Bölge kodu, ccTLD ("üst düzey alan") iki karakterlik değerini kabul eder. Çoğu ccTLD kodu, ISO 3166-1 kodlarıyla aynıdır ancak bazı önemli istisnalar vardır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" ( .co.uk), ISO 3166-1 kodu ise "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" için). |
sessionToken optional |
Tür:
AutocompleteSessionToken optionalTek tek istekleri oturumlar halinde 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. Tür belirtilmezse tüm türler döndürülür. |
AutocompleteResponse arayüzü
google.maps.places.AutocompleteResponse
arayüz
AutocompleteService.getPlacePredictions çağrısı tarafından döndürülen ve AutocompletePrediction listesini içeren bir Otomatik Tamamlama yanıtı.
Özellikler | |
|---|---|
predictions |
Tür:
Array<AutocompletePrediction>AutocompletePrediction listesi. |
QueryAutocompletionRequest arayüzü
google.maps.places.QueryAutocompletionRequest
arayüz
QueryAutocompleteService adresine gönderilecek bir QueryAutocompletion isteği.
Özellikler | |
|---|---|
input |
Tür:
stringKullanıcı giriş dizesini girdi. |
bounds optional |
Tür:
LatLngBounds|LatLngBoundsLiteral optionalTahmin önyargısı için sınırlar. Tahminler, belirtilen bounds öğesine yönelik olarak yanlı olacak ancak bununla sınırlı olmayacaktır. 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 şekillenecektir. Alternatif olarak bounds kullanılabilir. |
offset optional |
Tür:
number optionalHizmetin tahminler için metin kullandığı giriş terimindeki karakter konumu (giriş alanındaki imlecin 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 özelliğiyle birlikte verilmelidir. Alternatif olarak bounds kullanılabilir. |
ComponentRestrictions arayüzü
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 ülke (ISO 3166-1 Alpha-2 ülke kodu, büyük/küçük harfe duyarsız) ile sınırlar. Örneğin, 'us', 'br' veya 'au'. Tek bir ülke kodu dizesi veya en fazla beş ülke kodu dizesi içeren bir dizi sağlayabilirsiniz. |
AutocompletePrediction arayüzü
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>Kullanıcının girişindeki öğelerle eşleşen ve yer açıklamasındaki alt dizelerden oluşan bir grup. Bu alt dizeleri vurgulamak için kullanılabilir. Her alt dize, Unicode karakterleriyle ifade edilen bir ofset ve uzunlukla tanımlanır. |
place_id |
Tür:
stringYer ayrıntıları hizmeti kullanılarak bu yerle ilgili ayrıntıları almak için kullanılabilecek bir yer kimliği (bkz. PlacesService.getDetails). |
structured_formatting |
Tür:
StructuredFormattingYer açıklamasının ana metin ve ikincil metin olarak ayrılmış yapılandırılmış bilgileri. Otomatik tamamlama girişinden eşleşen alt dizelerin dizisini içerir. Bu dizeler, Unicode karakterleriyle ifade edilen bir ofset ve uzunluk ile tanımlanır. |
terms |
Tür:
Array<PredictionTerm>Yukarıdaki açıklamada yer alan terimler hakkında en belirgin olandan en az belirgin olana doğru bilgiler. Örneğin, "Taco Bell", "Willitis" ve "CA". |
types |
Tür:
Array<string>Tahminin ait olduğu türler dizisi (ör. 'establishment' veya 'geocode'). |
distance_meters optional |
Tür:
number optionalYerin AutocompletionRequest.origin konumuna olan uzaklığı (metre). |
QueryAutocompletePrediction arayüzü
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>Kullanıcının girişindeki öğelerle eşleşen ve yer açıklamasındaki alt dizelerden oluşan bir grup. Bu alt dizeleri vurgulamak için kullanılabilir. Her alt dize, Unicode karakterleriyle ifade edilen bir ofset ve uzunlukla tanımlanır. |
terms |
Tür:
Array<PredictionTerm>Yukarıdaki açıklamada yer alan terimler hakkında bilgi. Kategorik terimler önce gelir (örneğin, "restoran"). Adres terimleri en belirginden en az belirgin olana doğru gösterilir. Örneğin, "San Francisco" ve "CA". |
place_id optional |
Tür:
string optionalYalnızca tahmin bir yerse kullanılabilir. Yer ayrıntıları hizmeti kullanılarak bu yerle ilgili ayrıntıları almak için kullanılabilecek bir yer kimliği (bkz. PlacesService.getDetails). |
PredictionTerm arayüzü
google.maps.places.PredictionTerm
arayüz
Tahmin terimini gösterir.
Özellikler | |
|---|---|
offset |
Tür:
numberBu terimin yer açıklamasındaki başlangıcının Unicode karakterlerindeki uzaklığı. |
value |
Tür:
stringBu terimin değeri (ör. "Taco Bell"). |
PredictionSubstring arayüzü
google.maps.places.PredictionSubstring
arayüz
Tahmin alt dizesini ifade eder.
Özellikler | |
|---|---|
length |
Tür:
numberAlt dizenin uzunluğu. |
offset |
Tür:
numberAlt dizenin, açıklama dizesi içindeki başlangıcına olan uzaklık. |
StructuredFormatting arayüzü
google.maps.places.StructuredFormatting
arayüz
Yer açıklamasının ana metin ve ikincil metin olarak ayrılmış yapılandırılmış bilgilerini içerir. Bu bilgiler arasında, Unicode karakterleriyle ifade edilen, bir ofset ve uzunlukla tanımlanan, otomatik tamamlama girişinden eşleşen alt dizelerin dizisi de yer alır.
Ö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 dizeleri vurgulamak için uygun olan bir dizi alt dize. 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 bölümüdür. Genellikle yerin konumu. |