Places Autocomplete Service

AutocompleteService sınıfı

google.maps.places.AutocompleteService sınıf

Desteği sonlandırıldı: google.maps.places.AutocompleteService, 1 Mart 2025 itibarıyla yeni müşteriler tarafından kullanılamayacak. Lütfen bunun yerine AutocompleteSuggestion sütununu kullanın. Şu anda google.maps.places.AutocompleteService'in desteğinin sonlandırılması planlanmamaktadır ancak google.maps.places.AutocompleteService yerine AutocompleteSuggestion kullanılması önerilir. google.maps.places.AutocompleteService, büyük gerilemelerle ilgili hata düzeltmelerini almaya devam edecek ancak google.maps.places.AutocompleteService'teki mevcut hatalar düzeltilmeyecek. Destek sonlandırılmadan en az 12 ay önce bildirimde bulunulur. Ek bilgiler için lütfen https://developers.google.com/maps/legacy adresini, taşıma kılavuzu için ise https://developers.google.com/maps/documentation/javascript/places-migration-overview adresini ziyaret edin.

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:  request:  AutocompletionRequest Otomatik tamamlama isteği. callback:  function(Array<AutocompletePrediction> optional, PlacesServiceStatus): void optional AutocompletePrediction nesneleri dizisini ve PlacesServiceStatus değerini bağımsız değişken olarak kabul eden bir geri çağırma. İade 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 Otomatik sorgu tamamlama isteği. callback:  function(Array<QueryAutocompletePrediction> optional, PlacesServiceStatus): void QueryAutocompletePrediction nesneleri dizisini ve PlacesServiceStatus değerini bağımsız değişken olarak kabul eden bir geri çağırma. 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.
bounds optional	Desteği sonlandırıldı: bounds desteği Mayıs 2023 itibarıyla sonlandırıldı. Bunun yerine AutocompletionRequest.locationBias ve AutocompletionRequest.locationRestriction politikalarını kullanın. 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.
location optional	Desteği sonlandırıldı: location desteği Mayıs 2023 itibarıyla sonlandırıldı. Bunun yerine AutocompletionRequest.locationBias ve AutocompletionRequest.locationRestriction politikalarını kullanı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.
radius optional	Desteği sonlandırıldı: radius desteği Mayıs 2023 itibarıyla sonlandırıldı. Bunun yerine AutocompletionRequest.locationBias ve AutocompletionRequest.locationRestriction politikalarını kullanın. 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.