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 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:  request:  AutocompletionRequest Otomatik tamamlama isteği. callback:  function(Array<AutocompletePrediction> optional, PlacesServiceStatus): void optional Bağımsız değişken olarak bir dizi AutocompletePrediction nesnesini ve bir PlaceServiceStatus değerini 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 Sorgu otomatik tamamlama isteği. callback:  function(Array<QueryAutocompletePrediction> optional, PlacesServiceStatus): void Bağımsız değişken olarak bir dizi QueryAutocompletePrediction nesnesi ve bir PlaceServiceStatus değeri kabul edilir. 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.
bounds optional	Kullanımdan kaldırıldı: bounds Mayıs 2023 itibarıyla kullanımdan kaldırılmıştır. Bunun yerine AutocompletionRequest.locationBias ve AutocompletionRequest.locationRestriction politikalarını kullanın. 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.
location optional	Kullanımdan kaldırıldı: location Mayıs 2023 itibarıyla kullanımdan kaldırılmıştır. Bunun yerine AutocompletionRequest.locationBias ve AutocompletionRequest.locationRestriction politikalarını kullanı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.
radius optional	Kullanımdan kaldırıldı: radius Mayıs 2023 itibarıyla kullanımdan kaldırılmıştır. Bunun yerine AutocompletionRequest.locationBias ve AutocompletionRequest.locationRestriction politikalarını 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 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.