Places Autocomplete Service (deprecated)

AutocompleteService sınıfı

sınıf google.maps.places.AutocompleteService
kitaplık "places"

Desteği sonlandırıldı: google.maps.places.AutocompleteService, 1 Mart 2025'ten itibaren yeni müşteriler tarafından kullanılamayacak. Lütfen bunun yerine AutocompleteSuggestion sütunlarını kullanın. Şu anda google.maps.places.AutocompleteService'in kullanımdan kaldırılması planlanmamaktadır ancak google.maps.places.AutocompleteService yerine AutocompleteSuggestion kullanılması önerilir. google.maps.places.AutocompleteService, önemli gerilemeler için hata düzeltmeleri almaya devam edecek olsa da google.maps.places.AutocompleteService'teki mevcut hatalar giderilmeyecektir. Destek sonlandırılmadan en az 12 ay önce bildirim gönderilir. Daha fazla bilgi için https://developers.google.com/maps/legacy adresini, geçiş rehberi için 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");

Marka
AutocompleteService	AutocompleteService() Parametreler: Yok AutocompleteService için yeni bir örnek 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 bağımsız değişken olarak PlacesServiceStatus değerini kabul eden bir geri çağırma. Dönüş Değeri: Promise<AutocompleteResponse> Sağlanan otomatik tamamlama isteğine göre yer adı 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 QueryAutocompletePrediction nesnesi dizisi ve bir PlacesServiceStatus değeri kabul eden 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ü

arayüz google.maps.places.AutocompletionRequest

AutocompleteService.getPlacePredictions adresine gönderilecek bir otomatik tamamlama isteği.

Özellikler
input	Tür: string Kullanıcının girdiği giriş dizesi.
bounds isteğe bağlı	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 yanlılığı için sınırlar. Tahminler, belirtilen bounds ile sınırlı olmamakla birlikte bu değere doğru eğilim gösterir. bounds ayarlanırsa hem location hem de radius yoksayılır.
componentRestrictions isteğe bağlı	Tür: ComponentRestrictions optional Bileşen kısıtlamaları. Bileşen kısıtlamaları, tahminleri yalnızca üst bileşendekilerle sınırlamak için kullanılır. Örneğin, ülke.
language isteğe bağlı	Tür: string optional Mümkünse sonuçların döndürülmesi gereken dil için bir dil tanımlayıcı. Seçilen dildeki sonuçlar daha yüksek bir sıralamaya sahip olabilir ancak öneriler bu dille sınırlı değildir. Desteklenen dillerin listesine bakın.
location isteğe bağlı	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 yanlılığı için konum. Tahminler, belirtilen location ve radius değerlerine göre ağırlıklı olur. Alternatif olarak bounds kullanılabilir.
locationBias isteğe bağlı	Tür: LocationBias optional Yer ararken kullanılacak esnek bir sınır veya ipucu.
locationRestriction isteğe bağlı	Tür: LocationRestriction optional Arama sonuçlarını kısıtlayacak sınırlar.
offset isteğe bağlı	Tür: number optional Hizmetin tahminler için metin kullandığı giriş terimindeki karakter konumu (giriş alanındaki imlecin konumu).
origin isteğe bağlı	Tür: LatLng|LatLngLiteral optional AutocompletePrediction.distance_meters değerinin hesaplandığı konum.
radius isteğe bağlı	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 yanlılığı için kullanılan alanın yarıçapı. radius, metre cinsinden belirtilir ve her zaman bir location özelliğiyle birlikte kullanılmalıdır. Alternatif olarak bounds kullanılabilir.
region isteğe bağlı	Tür: string optional Sonuç biçimlendirme ve sonuç filtreleme için kullanılan bölge kodu. Öneriler bu ülkeyle sınırlı değildir. Bölge kodu, iki karakterli 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) 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 isteğe bağlı	Tür: AutocompleteSessionToken optional Tekil istekleri oturumlar halinde gruplandırmak için kullanılan benzersiz referans.
types isteğe bağlı	Tür: Array<string> optional Döndürülecek tahmin türleri. Desteklenen türler için geliştirici kılavuzuna bakın. Herhangi bir tür belirtilmezse tüm türler döndürülür.

AutocompleteResponse arayüzü

arayüz google.maps.places.AutocompleteResponse

AutocompleteService.getPlacePredictions çağrısı tarafından döndürülen ve AutocompletePrediction listesi içeren bir otomatik tamamlama yanıtı.

Özellikler
predictions	Tür: Array<AutocompletePrediction> AutocompletePrediction listesi.

QueryAutocompletionRequest arayüzü

arayüz google.maps.places.QueryAutocompletionRequest

QueryAutocompleteService adresine gönderilecek bir QueryAutocompletion isteği.

Özellikler
input	Tür: string Kullanıcının girdiği giriş dizesi.
bounds isteğe bağlı	Tür: LatLngBounds|LatLngBoundsLiteral optional Tahmin yanlılığı için sınırlar. Tahminler, belirtilen bounds ile sınırlı olmamakla birlikte bu değere doğru eğilim gösterir. bounds ayarlanırsa hem location hem de radius yoksayılır.
location isteğe bağlı	Tür: LatLng optional Tahmin yanlılığı için konum. Tahminler, belirtilen location ve radius değerlerine göre ağırlıklı olur. Alternatif olarak bounds kullanılabilir.
offset isteğe bağlı	Tür: number optional Hizmetin tahminler için metin kullandığı giriş terimindeki karakter konumu (giriş alanındaki imlecin konumu).
radius isteğe bağlı	Tür: number optional Tahmin yanlılığı için kullanılan alanın yarıçapı. radius, metre cinsinden belirtilir ve her zaman bir location özelliğiyle birlikte kullanılmalıdır. Alternatif olarak bounds kullanılabilir.

ComponentRestrictions arayüzü

arayüz google.maps.places.ComponentRestrictions

Otomatik tamamlama hizmetiyle kullanılabilecek bileşen kısıtlamalarını tanımlar.

Özellikler
country isteğe bağlı	Tür: string|Array<string> optional Tahminleri belirtilen ülkeyle kısıtlar (ISO 3166-1 Alfa-2 ülke kodu, büyük/küçük harfe duyarlı değildir). Örneğin, 'us', 'br' veya 'au'. Tek bir ülke kodu dizesi veya en fazla beş ülke kodu dizesinden oluşan bir dizi sağlayabilirsiniz.

AutocompletePrediction arayüzü

arayüz google.maps.places.AutocompletePrediction

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 kullanılmaya uygun bir alt dize grubu. Her alt dize, Unicode karakterlerle 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 (bkz. PlacesService.getDetails).
structured_formatting	Tür: StructuredFormatting Yerin açıklamasıyla ilgili yapılandırılmış bilgiler. Bu bilgiler, ana metin ve ikincil metin olarak ikiye ayrılır. Otomatik tamamlama girişinden eşleşen alt dizelerin bir dizisini içerir. Bu alt dizeler, ofset ve uzunluk ile tanımlanır ve Unicode karakterleriyle ifade edilir.
terms	Tür: Array<PredictionTerm> Yukarıdaki açıklamada yer alan terimlerle ilgili bilgiler (en özelden en genele doğru). Örneğin, "Taco Bell", "Willitis" ve "CA".
types	Tür: Array<string> Tahminin ait olduğu türlerin dizisi (ör. 'establishment' veya 'geocode').
distance_meters isteğe bağlı	Tür: number optional Yerin AutocompletionRequest.origin noktasına olan metre cinsinden mesafesi.

QueryAutocompletePrediction arayüzü

arayüz google.maps.places.QueryAutocompletePrediction

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 dizeleri vurgulamak için kullanılmaya uygun bir alt dize grubu. Her alt dize, Unicode karakterlerle ifade edilen bir ofset ve uzunlukla tanımlanır.
terms	Tür: Array<PredictionTerm> Yukarıdaki açıklamada yer alan terimlerle ilgili bilgiler. Kategori terimleri önce gelir (ör. "restoran"). Adres terimleri en özelden en genele doğru sıralanır. Örneğin, "San Francisco" ve "CA".
place_id isteğe bağlı	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ü

arayüz google.maps.places.PredictionTerm

Bir tahmin terimini temsil eder.

Özellikler
offset	Tür: number Bu terimin, yer açıklamasındaki başlangıcının Unicode karakter cinsinden ofseti.
value	Tür: string Bu terimin değeri (ör. "Taco Bell").

PredictionSubstring interface

arayüz google.maps.places.PredictionSubstring

Tahmin alt dizesini temsil eder.

Özellikler
length	Tür: number Alt dizenin uzunluğu.
offset	Tür: number Açıklama dizesi içinde alt dizenin başlangıcına olan fark.

StructuredFormatting arayüzü

arayüz google.maps.places.StructuredFormatting

Yerin açıklamasıyla ilgili yapılandırılmış bilgiler içerir. Bu bilgiler, ana metin ve ikincil metin olarak ikiye ayrılır. Otomatik tamamlama girişinden eşleşen alt dizelerin bir dizisini içerir. Bu alt dizeler, unicode karakterlerle ifade edilen bir ofset ve uzunluk ile tanımlanır.

Özellikler
main_text	Tür: string Bu, Places 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 kullanılabilecek bir alt dize grubu. Her alt dize, Unicode karakterlerle 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 konumudur.