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:
string Kullanıcı tarafından girilen giriş dizesi. |
|
Tür:
LatLngBounds|LatLngBoundsLiteral 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. |
|
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. |
|
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ı.
Ö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:
string Kullanıcı tarafından girilen giriş dizesi. |
bounds optional |
Tür:
LatLngBounds|LatLngBoundsLiteral 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.
Özellikler | |
---|---|
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.
Özellikler | |
---|---|
description |
Tür:
string Bu, 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:
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 |
Tür:
StructuredFormatting 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 |
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 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.
Özellikler | |
---|---|
description |
Tür:
string Bu, 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 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.
Özellikler | |
---|---|
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.
Özellikler | |
---|---|
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.
Özellikler | |
---|---|
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 |
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:
string Bu, Yerler hizmeti tarafından önerilen yerin biçimlendirilmemiş açıklamasının ikincil metin kısmıdır. Genellikle yerin konumu. |