Places Autocomplete Service

AutocompleteService sınıfı

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

Otomatik tamamlama tahminlerinin alınmasıyla ilgili yöntemleri içerir.

&libraries=places URL parametresini kullanarak yükleyin. Maps JavaScript API'deki kitaplıklar konusuna bakın.

v=beta kullanılırken const {AutocompleteService} = await google.map.importLibrary("places") kullanılarak arama yapılabilir. Maps JavaScript API'deki kitaplıklar konusuna bakın.

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 Bağımsız değişken olarak bir dizi AutocompletePrediction nesnesi ve bir PlaceServiceStatus değeri kabul eden 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 QueryAutocompletePrediction nesne dizisi ve bir PlaceServiceStatus değeri kabul eden bir geri çağırma. Return Değeri: Yok Sağlanan otomatik sorgu tamamlama isteğine göre otomatik sorgu tamamlama tahminleri 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ş dizesine girdi.
bounds optional	Tür: LatLngBounds|LatLngBoundsLiteral optional Tahmine ağırlık verme için sınırlar. Tahminler, bounds için ön yargıyla yaklaşılacak ancak bunlarla sınırlı olmayacaktır. bounds ayarlanırsa hem location hem de radius yok sayılır.
componentRestrictions optional	Tür: ComponentRestrictions optional Bileşen kısıtlamaları. Bileşen kısıtlamaları, tahminleri yalnızca üst bileşendekilerle 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 tanımlayıcı. 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	Tür: LatLng optional Tahmine ağırlık vermenin konumu. Tahminler, belirli bir location ve radius için ön yargılı olacaktır. 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).
origin optional	Tür: LatLng|LatLngLiteral optional AutocompletePrediction.distance_meters adlı yerin hesaplandığı konum.
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 özelliğiyle birlikte kullanılmalıdır. Alternatif olarak, bounds kullanılabilir.
region optional	Tür: string optional Sonuç biçimlendirmesi ve sonuç filtreleme için kullanılan bölge kodu. Öneriler bu ülkeyle sınırlı değildir. Bölge kodu ccTLD ("üst düzey alan") iki karakterli değeri 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 "Birleşik Krallık ve Kuzey İrlanda Birleşik Krallığı" içindir).
sessionToken optional	Tür: AutocompleteSessionToken optional Tek tek istekleri oturumlara 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ının döndürdüğü ve AutocompletePrediction listesinin yer aldığı bir otomatik tamamlama yanıtı.

Özellikler
predictions	Tür: Array<AutocompletePrediction> AutocompletePrediction adlı mülkün listesi.

QueryAutocompleteRequest arayüz

google.maps.places.QueryAutocompletionRequest arayüz

QueryAutocompleteService hizmetine gönderilecek bir Sorgu Otomatik Tamamlama isteği.

Özellikler
input	Tür: string Kullanıcı, giriş dizesine girdi.
bounds optional	Tür: LatLngBounds|LatLngBoundsLiteral optional Tahmine ağırlık verme için sınırlar. Tahminler, bounds için ön yargıyla yaklaşılacak ancak bunlarla sınırlı olmayacaktır. bounds ayarlanırsa hem location hem de radius yok sayılır.
location optional	Tür: LatLng optional Tahmine ağırlık vermenin konumu. Tahminler, belirli bir location ve radius için ön yargılı olacaktır. 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 özelliğiyle birlikte kullanılmalıdır. Alternatif olarak, bounds kullanılabilir.

AutocompleteSessionToken sınıfı

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

Otomatik tamamlama oturumunu izlemek için kullanılan oturum jetonunu gösterir. Bu oturum, bir AutocompleteService.getPlacePredictions arama dizisi ve ardından tek bir PlacesService.getDetails çağrısı olabilir.

&libraries=places URL parametresini kullanarak yükleyin. Maps JavaScript API'deki kitaplıklar konusuna bakın.

v=beta kullanılırken const {AutocompleteSessionToken} = await google.map.importLibrary("places") kullanılarak arama yapılabilir. Maps JavaScript API'deki kitaplıklar konusuna bakın.

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 Alfa-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 kodu 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ı içinde, 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 ve unicode karakterleriyle ifade edilir.
place_id	Tür: string Yer ayrıntıları hizmetini kullanarak bu yerle ilgili bilgileri almak için kullanılabilecek yer kimliği (bkz. PlacesService.getDetails).
structured_formatting	Tür: StructuredFormatting Yerin açıklamasıyla ilgili yapılandırılmış bilgiler, unicode karakterleriyle ifade edilen otomatik tamamlama girişinden eşleşen bir dizi alt dize içeren ana metin ve ikincil metin olarak ikiye ayrılır.
terms	Tür: Array<PredictionTerm> Yukarıdaki açıklamada bulunan, en çok belirginden en az spesifik olan terimlere dair bilgiler. Örneğin, "Bereket Döner", "Gizem" ve "İstanbul".
types	Tür: Array<string> Tahminin ait olduğu türler (ör. 'establishment' veya 'geocode').
distance_meters optional	Tür: number optional AutocompletionRequest.origin ile yerin metre cinsinden uzaklığı.

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> Yerin açıklaması içinde, 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 ve unicode karakterleriyle ifade edilir.
terms	Tür: Array<PredictionTerm> Yukarıdaki açıklamada ayrı ayrı terimler hakkında bilgiler. Kategorik terimler (örneğin, "restoran") önce gelir. 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 yerse kullanılabilir. Yer ayrıntıları hizmetini kullanarak bu yerle ilgili bilgileri almak için kullanılabilecek 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ındaki unicode karakterlerindeki ofset.
value	Tür: string Bu terimin değeri, örneğin, "Bereket Çan".

PredictionSubstring 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 uzaklık.

Yapılandırılmış Biçimlendirme arayüzü

google.maps.places.StructuredFormatting arayüz

Yerin açıklamasıyla ilgili yapılandırılmış bilgiler, otomatik tamamlama girişinden itibaren belirli bir uzaklık ve uzunlukla tanımlanan, unicode karakterleriyle ifade edilen bir dizi eşleşen alt dize dahil olmak üzere ana metne ve ikincil metne bölünür.

Ö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şinde yer alan öğelerle eşleşen, bu alt dizeleri vurgulamak için uygun alt dizeler. Her alt dize, bir ofset ve bir uzunlukla tanımlanır ve unicode karakterleriyle ifade edilir.
secondary_text	Tür: string Bu, Rehber hizmeti tarafından önerilen yerin biçimlendirilmemiş açıklamasının ikincil metin bölümüdür. Genellikle yerin konumudur.