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:
İ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.
Ö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. |