Places Autocomplete Service

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 konusuna bakın.

Marka
AutocompleteService	AutocompleteService() Parametreler: Yok Yeni AutocompleteService örneğini oluşturur.

Yöntemler
getPlacePredictions	getPlacePredictions(request[, callback]) Parametreler:  request:  AutocompletionRequest Otomatik tamamlama isteği. callback:  function(Array<AutocompletePrediction> optional, PlacesServiceStatus): void optional Bir AutocompleteTahmini nesne dizisi ve bir PlacesServiceStatus değeri bağımsız değişken olarak kabul edilen geri çağırma. Dönüş Değeri:  Promise<AutocompleteResponse> Sağlanan otomatik tamamlama isteğine göre yer otomatik tamamlama tahminlerini alır.
getQueryPredictions	getQueryPredictions(request, callback) Parametreler:  request:  QueryAutocompletionRequest Sorgu otomatik tamamlama isteği. callback:  function(Array<QueryAutocompletePrediction> optional, PlacesServiceStatus): void Bağımsız değişken olarak bir QueryAutocomplete tahmin nesnesi dizisi ve PlacesServiceStatus değeri kabul edilen bir geri çağırma. Return Value: 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ı girdi dizesi girdi.
bounds optional	Desteği sonlandırıldı: bounds Mayıs 2023 itibarıyla kullanımdan kaldırıldı. Bunun yerine AutocompletionRequest.locationBias ve AutocompletionRequest.locationRestriction değerlerini kullanın. Tür:  LatLngBounds|LatLngBoundsLiteral optional Tahmine ağırlık vermenin sınırları. Tahminler, belirtilen bounds için eğilim gösterir ancak bunlarla sınırlı değildir. bounds ayarlanırsa location ve 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şende bulunanlarla 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 dildeki sonuçlara daha yüksek bir sıralama verilebilir, ancak öneriler bu dille sınırlı değildir. Desteklenen dillerin listesine bakın.
location optional	Desteği sonlandırıldı: location Mayıs 2023 itibarıyla kullanımdan kaldırıldı. Bunun yerine AutocompletionRequest.locationBias ve AutocompletionRequest.locationRestriction değerlerini kullanın. Tür:  LatLng optional Tahmine ağırlık verme konumu. Tahminler, belirtilen location ve radius öğelerine göre ağırlıklandırılır. 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ırlandırmak için sınırlar.
offset optional	Tür:  number optional Hizmetin, tahmin 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.
radius optional	Desteği sonlandırıldı: radius Mayıs 2023 itibarıyla kullanımdan kaldırıldı. Bunun yerine AutocompletionRequest.locationBias ve AutocompletionRequest.locationRestriction değerlerini kullanın. Tür:  number optional Tahmine ağırlık vermek için kullanılan alanın yarıçapı. radius, metre cinsinden belirtilir ve her zaman location özelliğiyle birlikte kullanılmalıdır. Alternatif olarak bounds kullanılabilir.
region optional	Tür:  string optional Sonuç biçimlendirme ve sonuç filtreleme için kullanılan bir bölge kodu. Önerileri bu ülkeyle kısıtlamaz. Bölge kodu, iki karakterden oluşan bir 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) ve ISO 3166-1 kodu "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallık'ı" için kullanılır).
sessionToken optional	Tür:  AutocompleteSessionToken optional Bağımsız 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. Hiçbir 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ının döndürdüğü, 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 cihazına gönderilecek bir Sorgu Otomatik Tamamlama isteği.

Özellikler
input	Tür:  string Kullanıcı girdi dizesi girdi.
bounds optional	Tür:  LatLngBounds|LatLngBoundsLiteral optional Tahmine ağırlık vermenin sınırları. Tahminler, belirtilen bounds için eğilim gösterir ancak bunlarla sınırlı değildir. bounds ayarlanırsa location ve radius yoksayılır.
location optional	Tür:  LatLng optional Tahmine ağırlık verme konumu. Tahminler, belirtilen location ve radius öğelerine göre ağırlıklandırılır. Alternatif olarak bounds kullanılabilir.
offset optional	Tür:  number optional Hizmetin, tahmin 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 location özelliğiyle birlikte kullanılmalıdır. 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 ülkeyle kısıtlar (ISO 3166-1 Alpha-2 ülke kodu, büyük/küçük harfe duyarlı değildir). Örneğin, 'us', 'br' veya 'au'. Tek bir tane veya en fazla beş ülke kodu dizesi sağlayabilirsiniz.

AutocompletePrediction arayüzü

google.maps.places.AutocompletePrediction arayüz

Tek bir otomatik tamamlama tahminini temsil eder.

Özellikler
description	Tür:  string Bu, sorgunun Rehber hizmeti tarafından önerilen 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, bu alt dizelerin vurgulanmasında kullanılmaya uygun bir alt dize grubu. Her alt dize, unicode karakterleriyle ifade edilen bir ofset ve uzunluk ile 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 yer kimliği (bkz. PlacesService.getDetails).
structured_formatting	Tür:  StructuredFormatting Yerin açıklamasıyla ilgili, ana metne ve ikincil metne bölünmüş yapılandırılmış bilgiler. Bu bilgiler arasında, otomatik tamamlama girişinden alınan, ofset ve uzunlukla tanımlanan, unicode karakterleriyle ifade edilen eşleşen alt dizeler dizisi bulunur.
terms	Tür:  Array<PredictionTerm> Yukarıdaki açıklamada yer alan, en çok spesifik olandan en az spesifik olana doğru tek tek terimlerle ilgili bilgiler. Örneğin, "Bereket", "Merve" ve "Özge".
types	Tür:  Array<string> Tahminin ait olduğu bir tür dizisi (ör. 'establishment' veya 'geocode').
distance_meters optional	Tür:  number optional Yerin AutocompletionRequest.origin ile arasındaki metre cinsinden mesafesi.

QueryAutocompletePrediction arayüzü

google.maps.places.QueryAutocompletePrediction arayüz

Tek bir Sorgu Otomatik Tamamlama tahminini temsil eder.

Özellikler
description	Tür:  string Bu, sorgunun Rehber hizmeti tarafından önerilen 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, bu alt dizelerin vurgulanmasında kullanılmaya uygun bir alt dize grubu. Her alt dize, unicode karakterleriyle ifade edilen bir ofset ve uzunluk ile tanımlanır.
terms	Tür:  Array<PredictionTerm> Yukarıdaki açıklamada, her bir terimle ilgili bilgiler yer alır. Kategorik terimler önce gelir (örneğin, "restoran"). Adres terimleri, en spesifikten en az spesifik olana doğru sıralanmıştır. Örneğin, "İstanbul" ve "İstanbul".
place_id optional	Tür:  string optional Yalnızca tahmin bir yerse kullanılabilir. Yer ayrıntıları hizmetini kullanarak bu yerle ilgili ayrıntıları almak için kullanılabilecek yer kimliği (bkz. PlacesService.getDetails).

PredictionTerm arayüzü

google.maps.places.PredictionTerm arayüz

Tahmin terimini temsil eder.

Özellikler
offset	Tür:  number Bu terimin başlangıcının, yerin açıklamasında, unicode karakterleriyle belirtilen ofseti.
value	Tür:  string Bu terimin değeri (ör. "Taco Bell")

PredictionSubstring arayüzü

google.maps.places.PredictionSubstring arayüz

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.

StructuredFormatting arayüzü

google.maps.places.StructuredFormatting arayüz

Yerin açıklaması hakkında, ana metne ve ikincil metne bölünmüş yapılandırılmış bilgiler içerir. Bu bilgiler arasında, otomatik tamamlama girişinden, unicode karakterleriyle ifade edilen uzaklık ve uzunlukla tanımlanan bir dizi eşleşen alt dize dahildir.

Ö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ıdır.
main_text_matched_substrings	Tür:  Array<PredictionSubstring> Ana metinde, kullanıcının girişindeki öğelerle eşleşen, bu alt dizelerin vurgulanmasında kullanılmaya uygun bir alt dize grubu. Her alt dize, unicode karakterleriyle ifade edilen bir ofset ve uzunluk ile 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 konumudur.