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:
string Kullanıcı giriş dizesini girdi. |
|
Tür:
LatLngBounds|LatLngBoundsLiteral optional Tahmin ö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 optional Bileş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 optional Mü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 optional Tahmin ö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 optional Yer ararken kullanılacak yumuşak bir sınır veya ipucu. |
locationRestriction optional |
Tür:
LocationRestriction optional Arama sonuçlarını sınırlamak için kullanılan sınırlar. |
offset optional |
Tür:
number optional Hizmetin tahminler için metin kullandığı giriş terimindeki karakter konumu (giriş alanındaki imlecin 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 özelliğiyle birlikte verilmelidir. Alternatif olarak bounds kullanılabilir. |
region optional |
Tür:
string optional Sonuç 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 optional Tek tek istekleri oturumlar halinde 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. 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:
string Kullanıcı giriş dizesini girdi. |
bounds optional |
Tür:
LatLngBounds|LatLngBoundsLiteral optional Tahmin ö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 optional Tahmin ö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 optional Hizmetin tahminler için metin kullandığı giriş terimindeki karakter konumu (giriş alanındaki imlecin 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 ö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> optional Tahminleri 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:
string Bu, 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:
string 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 ). |
structured_formatting |
Tür:
StructuredFormatting Yer 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 optional Yerin 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:
string Bu, 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 optional Yalnı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:
number Bu terimin yer açıklamasındaki başlangıcının Unicode karakterlerindeki uzaklığı. |
value |
Tür:
string Bu terimin değeri (ör. "Taco Bell"). |
PredictionSubstring arayüzü
google.maps.places.PredictionSubstring
arayüz
Tahmin alt dizesini ifade eder.
Özellikler | |
---|---|
length |
Tür:
number Alt dizenin uzunluğu. |
offset |
Tür:
number Alt 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:
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 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:
string Bu, Yerler hizmeti tarafından önerilen yerin biçimlendirilmemiş açıklamasının ikincil metin bölümüdür. Genellikle yerin konumu. |