Places Autocomplete Service

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

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.
AutocompleteService
AutocompleteService()
Parametreler: Yok
AutocompleteService öğesinin yeni bir örneğini oluşturur.
getPlacePredictions
getPlacePredictions(request[, callback])
Parametreler:
İade Değeri: Promise<AutocompleteResponse>
Sağlanan otomatik tamamlama isteğine göre yer otomatik tamamlama tahminlerini alır.
getQueryPredictions
getQueryPredictions(request, callback)
Parametreler:
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.
input
Tür: string
Kullanıcı, giriş dizesine girdi.
bounds 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
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ı.
predictions
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.
input
Tür: string
Kullanıcı, giriş dizesine girdi.
bounds 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.
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.
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.
description
Tür: string
Bu, Yerler hizmeti tarafından önerilen sorgunun biçimlendirilmemiş sürümüdür.
matched_substrings
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
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
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.
description
Tür: string
Bu, Yerler hizmeti tarafından önerilen sorgunun biçimlendirilmemiş sürümüdür.
matched_substrings
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
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.
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.
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.
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
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.