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 konusuna bakın.

AutocompleteService
AutocompleteService()
Parametreler: Yok
Yeni AutocompleteService örneğini oluşturur.
getPlacePredictions
getPlacePredictions(request[, callback])
Parametreler: 
Dönüş Değeri:  Promise<AutocompleteResponse>
Sağlanan otomatik tamamlama isteğine göre yer otomatik tamamlama tahminlerini alır.
getQueryPredictions
getQueryPredictions(request, callback)
Parametreler: 
Return Value: 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.

input
Tür:  string
Kullanıcı girdi dizesi girdi.
bounds optional
Tahmine ağırlık vermenin sınırları. Tahminler, belirtilen bounds için eğilim gösterir ancak bunlarla sınırlı değildir. bounds ayarlanırsa location ve 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şende bulunanlarla 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 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
Tür:  LatLng optional
Tahmine ağırlık verme konumu. Tahminler, belirtilen location ve radius öğelerine göre ağırlıklandırılır. 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ırlandırmak için sınırlar.
offset optional
Tür:  number optional
Hizmetin, tahmin 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
Tür:  number optional
Tahmine ağırlık vermek için kullanılan alanın yarıçapı. radius, metre cinsinden belirtilir ve her zaman location özelliğiyle birlikte kullanılmalıdır. Alternatif olarak bounds kullanılabilir.
region optional
Tür:  string optional
Sonuç biçimlendirme ve sonuç filtreleme için kullanılan bir bölge kodu. Önerileri bu ülkeyle kısıtlamaz. Bölge kodu, iki karakterden oluşan 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) ve ISO 3166-1 kodu "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallık'ı" için kullanılır).
sessionToken optional
Tür:  AutocompleteSessionToken optional
Bağımsız 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. Hiçbir 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üğü, AutocompletePrediction listesini içeren bir Otomatik Tamamlama yanıtı.

predictions

QueryAutocompletionRequest arayüzü

google.maps.places.QueryAutocompletionRequest arayüz

QueryAutocompleteService cihazına gönderilecek bir Sorgu Otomatik Tamamlama isteği.

input
Tür:  string
Kullanıcı girdi dizesi girdi.
bounds optional
Tahmine ağırlık vermenin sınırları. Tahminler, belirtilen bounds için eğilim gösterir ancak bunlarla sınırlı değildir. bounds ayarlanırsa location ve radius yoksayılır.
location optional
Tür:  LatLng optional
Tahmine ağırlık verme konumu. Tahminler, belirtilen location ve radius öğelerine göre ağırlıklandırılır. Alternatif olarak bounds kullanılabilir.
offset optional
Tür:  number optional
Hizmetin, tahmin 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 location özelliğiyle birlikte kullanılmalıdır. 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.

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

AutocompletePrediction arayüzü

google.maps.places.AutocompletePrediction arayüz

Tek bir otomatik tamamlama tahminini temsil eder.

description
Tür:  string
Bu, sorgunun Rehber hizmeti tarafından önerilen biçimlendirilmemiş sürümüdür.
matched_substrings
Yerin açıklamasında, kullanıcının girişindeki öğelerle eşleşen, bu alt dizelerin vurgulanmasında kullanılmaya uygun bir alt dize grubu. Her alt dize, unicode karakterleriyle ifade edilen bir ofset ve uzunluk ile 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 yer kimliği (bkz. PlacesService.getDetails).
structured_formatting
Yerin açıklamasıyla ilgili, ana metne ve ikincil metne bölünmüş yapılandırılmış bilgiler. Bu bilgiler arasında, otomatik tamamlama girişinden alınan, ofset ve uzunlukla tanımlanan, unicode karakterleriyle ifade edilen eşleşen alt dizeler dizisi bulunur.
terms
Yukarıdaki açıklamada yer alan, en çok spesifik olandan en az spesifik olana doğru tek tek terimlerle ilgili bilgiler. Örneğin, "Bereket", "Merve" ve "Özge".
types
Tür:  Array<string>
Tahminin ait olduğu bir tür dizisi (ör. 'establishment' veya 'geocode').
distance_meters optional
Tür:  number optional
Yerin AutocompletionRequest.origin ile arasındaki metre cinsinden mesafesi.

QueryAutocompletePrediction arayüzü

google.maps.places.QueryAutocompletePrediction arayüz

Tek bir Sorgu Otomatik Tamamlama tahminini temsil eder.

description
Tür:  string
Bu, sorgunun Rehber hizmeti tarafından önerilen biçimlendirilmemiş sürümüdür.
matched_substrings
Yerin açıklamasında, kullanıcının girişindeki öğelerle eşleşen, bu alt dizelerin vurgulanmasında kullanılmaya uygun bir alt dize grubu. Her alt dize, unicode karakterleriyle ifade edilen bir ofset ve uzunluk ile tanımlanır.
terms
Yukarıdaki açıklamada, her bir terimle ilgili bilgiler yer alır. Kategorik terimler önce gelir (örneğin, "restoran"). Adres terimleri, en spesifikten en az spesifik olana doğru sıralanmıştır. Örneğin, "İstanbul" 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 ayrıntıları almak için kullanılabilecek yer kimliği (bkz. PlacesService.getDetails).

PredictionTerm arayüzü

google.maps.places.PredictionTerm arayüz

Tahmin terimini temsil eder.

offset
Tür:  number
Bu terimin başlangıcının, yerin açıklamasında, unicode karakterleriyle belirtilen ofseti.
value
Tür:  string
Bu terimin değeri (ör. "Taco Bell")

PredictionSubstring arayüzü

google.maps.places.PredictionSubstring arayüz

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 ofset.

StructuredFormatting arayüzü

google.maps.places.StructuredFormatting arayüz

Yerin açıklaması hakkında, ana metne ve ikincil metne bölünmüş yapılandırılmış bilgiler içerir. Bu bilgiler arasında, otomatik tamamlama girişinden, unicode karakterleriyle ifade edilen uzaklık ve uzunlukla tanımlanan bir dizi eşleşen alt dize dahildir.

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şindeki öğelerle eşleşen, bu alt dizelerin vurgulanmasında kullanılmaya uygun bir alt dize grubu. Her alt dize, unicode karakterleriyle ifade edilen bir ofset ve uzunluk ile 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 konumudur.