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şin. Haritalar JavaScript API'sindeki kitaplıklar başlıklı bölümü inceleyin.
Marka | |
---|---|
AutocompleteService |
AutocompleteService() Parametreler: Yok
Yeni bir AutocompleteService örneği 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:
Return Value: Yok
Sağlanan sorgu otomatik tamamlama isteğine göre sorgu otomatik tamamlama tahminlerini alır. |
AutocompleteRequest 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 Tahmine ağırlık verme sınırları. Tahminler, belirtilen bounds ile sınırlı olmamakla birlikte önyargılı olabilir. 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 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 bir dil tanımlayıcısı. Seçilen dildeki sonuçlara daha yüksek bir sıralama verilebilir ancak öneriler bu dille sınırlı değildir. Desteklenen dillerin listesine bakın. |
|
Tür:
LatLng optional Tahmine ağırlık verme konumu. Tahminler, belirtilen location ve radius doğrultusunda önyargılı olur. Alternatif olarak, bounds kullanılabilir. |
locationBias optional |
Tür:
LocationBias optional Yer ararken kullanabileceğiniz yumuşak bir sınır veya ipucu. |
locationRestriction optional |
Tür:
LocationRestriction optional Arama sonuçlarını kısıtlamak için kullanılan sınırlar. |
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 Tahmine ağırlık vermek için kullanılan alanın yarıçapı. radius , metre cinsinden belirtilir ve her zaman bir location mülküyle birlikte kullanılmalıdır. Alternatif olarak, bounds kullanılabilir. |
region optional |
Tür:
string optional Sonuç biçimlendirmesi ve sonuç filtrelemesi için kullanılan bir bölge kodu. Önerilerin kısıtlanmaması için bu ülke kullanılır. Bölge kodu, iki karakterli ccTLD ("üst düzey alan") değerini kabul eder. Çoğu ccTLD kodu, bazı önemli istisnalar dışında ISO 3166-1 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" ( .co.uk ), ISO 3166-1 kodu ise "gb"dır (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" için). |
sessionToken optional |
Tür:
AutocompleteSessionToken optional Ayrı 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
AutocompletePrediction
işlevinin listesini içeren AutocompleteService.getPlacePredictions
aramasına döndürülen otomatik tamamlama yanıtı.
Özellikler | |
---|---|
predictions |
Tür:
Array<AutocompletePrediction> AutocompletePrediction listesi. |
Sorgu Otomatik Tamamlama İsteği arayüzü
google.maps.places.QueryAutocompletionRequest
arayüz
QueryAutocompleteService
adresine gönderilecek bir Sorgu Otomatik Tamamlama isteği.
Özellikler | |
---|---|
input |
Tür:
string Kullanıcı, giriş dizesini girdi. |
bounds optional |
Tür:
LatLngBounds|LatLngBoundsLiteral optional Tahmine ağırlık verme sınırları. Tahminler, belirtilen bounds ile sınırlı olmamakla birlikte önyargılı olabilir. bounds ayarlanırsa hem location hem de radius yoksayılır. |
location optional |
Tür:
LatLng optional Tahmine ağırlık verme konumu. Tahminler, belirtilen location ve radius doğrultusunda önyargılı olur. Alternatif olarak, bounds 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 Tahmine ağırlık vermek için kullanılan alanın yarıçapı. radius , metre cinsinden belirtilir ve her zaman bir location mülküyle birlikte kullanılmalıdır. Alternatif olarak, bounds kullanılabilir. |
AutocompleteSessionToken sınıfı
google.maps.places.AutocompleteSessionToken
sınıf
Bir otomatik tamamlama oturumunu izlemek için kullanılan oturum jetonunu temsil eder. Bu oturum, AutocompleteService.getPlacePredictions
arama dizisinden sonra gelen tek bir PlacesService.getDetails
çağrısı olabilir.
const {AutocompleteSessionToken} = await google.maps.importLibrary("places")
numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki kitaplıklar başlıklı bölümü inceleyin.
Marka | |
---|---|
AutocompleteSessionToken |
AutocompleteSessionToken() Parametreler: Yok
Yeni bir AutocompleteSessionToken örneği oluşturur. |
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 ülkeyle sınırlar (ISO 3166-1 Alpha-2 ülke kodu, büyük/küçük harfe duyarlı değildir). Örneğin, 'us' , 'br' veya 'au' . Tek bir kod veya en fazla beş ülke kod dizesi dizisi 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> Yerin açıklamasında, kullanıcının girişindeki öğelerle eşleşen ve bu alt dizeleri vurgulamak için uygun olan bir alt dize grubu. Her alt dize, bir ofset ve bir uzunlukla tanımlanır. Unicode karakterleriyle belirtilir. |
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 (bkz. PlacesService.getDetails ). |
structured_formatting |
Tür:
StructuredFormatting Yerin açıklamasıyla ilgili yapılandırılmış bilgiler, otomatik tamamlama girişinden oluşan bir dizi eşleşen alt dize de dahil olmak üzere ana metin ve ikincil metinden oluşur. Boşluk ve uzunluk, unicode karakterleriyle ifade edilir. |
terms |
Tür:
Array<PredictionTerm> Yukarıdaki açıklamada yer alan, en çok belirgin olandan en az belirgin olan terimlere dair bilgiler. Ö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 AutocompletionRequest.origin arasındaki yerin metre cinsinden mesafesi. |
QueryAutocompletePrediction arayüzü
google.maps.places.QueryAutocompletePrediction
arayüz
Tek bir otomatik sorgu 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 dizeleri vurgulamak için uygun olan bir alt dize grubu. Her alt dize, bir ofset ve bir uzunlukla tanımlanır. Unicode karakterleriyle belirtilir. |
terms |
Tür:
Array<PredictionTerm> Yukarıdaki açıklamada ayrı ayrı terimler hakkında bilgiler. Kategorik terimler önceliklidir (örneğin, "restoran"). Adres terimleri en belirginden en az belirgin olana doğru görünür. Örneğin, "Ankara" ve "İstanbul". |
place_id optional |
Tür:
string optional Yalnızca tahmin bir yer olduğunda kullanılabilir. Yer ayrıntıları hizmetini kullanarak 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
Bir tahmin terimini temsil eder.
Özellikler | |
---|---|
offset |
Tür:
number Yerin açıklamasında bu terimin başlangıcının unicode karakterlerindeki göreli konumu. |
value |
Tür:
string Bu terimin değeri (ör. "Taco Bell"). |
Tahmin Alt Dizesi 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 Açıklama dizesinde alt dizenin başlangıcına olan ofset. |
YapılandırılmışBiçimlendirme arayüzü
google.maps.places.StructuredFormatting
arayüz
Yerin açıklamasıyla ilgili yapılandırılmış bilgileri içerir. Bu bilgiler, otomatik tamamlama girişinden oluşan bir dizi eşleşen alt dize de dahil olmak üzere bir ana metin ve ikincil bir metin dizisi ile unicode karakterleriyle ifade edilmiş bir göreli uzunluk dizesi içerir.
Özellikler | |
---|---|
main_text |
Tür:
string Bu, Yerler hizmeti tarafından önerilen yerin biçimlendirilmemiş açıklamasının ana metin bölümüdür. Genellikle yerin adı. |
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ı için uygun olan bir alt dize kümesi. Her alt dize, bir ofset ve bir uzunlukla tanımlanır. Unicode karakterleriyle belirtilir. |
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. |