Autocomplete Data (new)

AutocompleteRequest arayüzü

google.maps.places.AutocompleteRequest arayüz

AutocompleteSuggestion.fetchAutocompleteSuggestions için arayüz isteği.

input
Tür:  string
Arama yapılacak metin dizesi.
includedPrimaryTypes optional
Tür:  Array<string> optional
Birincil Yer türü dahil (örneğin, "restoran" veya "gaz_station").

Bir Yer yalnızca birincil türü bu listede yer alıyorsa döndürülür. En fazla 5 değer belirtilebilir. Herhangi bir tür belirtilmezse tüm Yer türleri döndürülür.
includedRegionCodes optional
Tür:  Array<string> optional
En fazla 15 CLDR iki karakterli bölge kodu olarak belirtilen, yalnızca belirtilen bölgelerdeki sonuçları dahil edin. Boş küme sonuçları kısıtlamaz. Hem locationRestriction hem de includedRegionCodes ayarlanırsa sonuçlar kesişim alanında bulunur.
inputOffset optional
Tür:  number optional
İmlecin input içindeki konumunu gösteren sıfır tabanlı Unicode karakter farkı: input. İmleç konumu, hangi tahminlerin döndürüleceğini etkileyebilir. Belirtilmezse varsayılan olarak input uzunluğunda olur.
language optional
Tür:  string optional
Sonuçların döndürüleceği dil. Varsayılan olarak tarayıcının dil tercihine ayarlanır. input dilinde kullanılan dil language dilinden farklıysa veya döndürülen Yerin yerel dilden language diline çevirisi yoksa sonuçlar karışık dilde olabilir.
locationBias optional
Tür:  LocationBias optional
Belirtilen konum için yanlılık sonuçları.

locationBias veya locationRestriction özelliklerinden en fazla biri ayarlanmalıdır. İkisi de ayarlanmazsa sonuçlar IP adresine göre ağırlıklandırılır, yani IP adresi tam olmayan bir konumla eşlenir ve ağırlık verme sinyali olarak kullanılır.
locationRestriction optional
Tür:  LocationRestriction optional
Sonuçları belirtilen bir konumla sınırlandırın.

locationBias veya locationRestriction özelliklerinden en fazla biri ayarlanmalıdır. İkisi de ayarlanmazsa sonuçlar IP adresine göre ağırlıklandırılır, yani IP adresi tam olmayan bir konumla eşlenir ve ağırlık verme sinyali olarak kullanılır.
origin optional
Tür:  LatLng|LatLngLiteral optional
Hedefe olan jeodezik mesafenin hesaplanacağı başlangıç noktası (PlacePrediction.distanceMeters olarak döndürülür). Bu değer atlanırsa jeodezik mesafe döndürülmez.
region optional
Tür:  string optional
İki karakterli CLDR bölge kodu olarak belirtilen bölge kodu. Bu, adres biçimlendirmesini, sonuç sıralamasını etkiler ve hangi sonuçların döndürüleceğini etkileyebilir. Bu işlem, sonuçları belirtilen bölgeyle kısıtlamaz.
sessionToken optional
Tür:  AutocompleteSessionToken optional
Faturalandırma amacıyla bir Otomatik Tamamlama oturumunu tanımlayan jeton. AutocompleteSessionToken aracılığıyla yeni bir oturum jetonu oluşturun.

Oturum, kullanıcı bir sorgu yazmaya başladığında başlar ve kullanıcı bir yer seçip Place.fetchFields numaralı telefonu aradığında sona erer. Her oturumda birden fazla sorgu ve ardından bir fetchFields çağrısı olabilir. Bir oturumdaki her istek için kullanılan kimlik bilgileri aynı Google Cloud Console projesine ait olmalıdır. Oturum sona erdiğinde jeton artık geçerli olmaz. Bu nedenle uygulamanız her oturum için yeni bir jeton oluşturmalıdır. sessionToken parametresi atlanırsa veya bir oturum jetonunu yeniden kullanırsanız oturum, herhangi bir oturum jetonu sağlanmamış gibi ücretlendirilir (her istek ayrı olarak faturalandırılır).

Aşağıdaki yönergeleri öneririz:
  • Tüm Otomatik Yer Tamamlama çağrıları için oturum jetonları kullanın.
  • Her oturum için yeni bir jeton oluşturun.
  • Her yeni oturum için benzersiz bir oturum jetonu ilettiğinizden emin olun. Aynı jetonun birden fazla oturum için kullanılması, her isteğin ayrı olarak faturalandırılır.

AutocompleteSessionToken sınıfı

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

Otomatik tamamlama oturumunu izlemek için kullanılan bir oturum jetonunu temsil eder.

const {AutocompleteSessionToken} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişebilirsiniz. Haritalar JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

AutocompleteSessionToken
AutocompleteSessionToken()
Parametreler: Yok
Yeni bir AutocompleteSessionToken örneği oluşturur.

AutocompleteSuggestion sınıf

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

Otomatik tamamlama önerisi sonucu.

const {AutocompleteSuggestion} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişebilirsiniz. Haritalar JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
Parametreler: 
Döndürülen Değeri:  Promise<{suggestions:Array<AutocompleteSuggestion>}>
Otomatik Tamamlama Önerileri listesini getirir.
placePrediction
Tür:  PlacePrediction optional
Döndürülen sonucun kullanıcılar tarafından okunabilen adını içerir. Kuruluş sonuçlarında genellikle işletme adı ve adresi kullanılır.

PlacePrediction sınıfı

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

Yer Otomatik Tamamlama tahmini için tahmin sonuçları.

const {PlacePrediction} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişebilirsiniz. Haritalar JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

distanceMeters
Tür:  number optional
origin belirtilmişse jeodezinin metre cinsinden uzunluğu origin belirtilir.
mainText
Tür:  FormattableText optional
Yerin adını temsil eder.
placeId
Tür:  string
Önerilen yerin benzersiz tanımlayıcısı. Bu tanımlayıcı, Yer Kimliklerini kabul eden diğer API'lerde kullanılabilir.
secondaryText
Tür:  FormattableText optional
Yeri daha iyi tanımlayan, belirsizlik yaratan ek özellikleri (şehir veya bölge gibi) temsil eder.
text
Döndürülen sonucun kullanıcılar tarafından okunabilen adını içerir. Kuruluş sonuçlarında genellikle işletme adı ve adresi kullanılır.

text, tek bir kullanıcı arayüzü öğesi göstermek isteyen geliştiriciler için önerilir. Ayrı ancak alakalı iki kullanıcı arayüzü öğesi göstermek isteyen geliştiriciler bunun yerine PlacePrediction.mainText ve PlacePrediction.secondaryText öğelerini kullanmak isteyebilir.
types
Tür:  Array<string>
https://developers.google.com/maps/documentation/places/web-service/place-types adresindeki A veya B tablosundan bu Yer için geçerli olan türlerin listesi.
toPlace
toPlace()
Parametreler: Yok
Döndürülen Değeri:  Place
Bu PlaceTahmini için Yer gösterimini döndürür. Yerle ilgili tüm ayrıntıları öğrenmek için bir sonraki Place.fetchFields araması gerekiyor.

StringRange sınıfı

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

Belirli bir metinde bir alt dizeyi tanımlar.

const {StringRange} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişebilirsiniz. Haritalar JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

endOffset
Tür:  number
Alt dizenin son Unicode karakterinin sıfır tabanlı uzaklığı (hariç).
startOffset
Tür:  number
Alt dizenin ilk Unicode karakterinin (dahil) sıfır tabanlı uzaklığı.

FormattableText sınıfı

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

Yer tahminini temsil eden metin. Metin olduğu veya biçimlendirildiği şekilde kullanılabilir.

const {FormattableText} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişebilirsiniz. Haritalar JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

matches
Giriş isteğinin FormattableText.text içinde nerede eşleştiğini tanımlayan dize aralıklarının listesi. Aralıklar, text öğesinin belirli bölümlerini biçimlendirmek için kullanılabilir. Eşleşme, dize eşleştirme dışındaki ölçütler (örneğin, yazım düzeltmeleri veya harf çevirisiler) tarafından belirlendiyse alt dizeler, AutocompleteRequest.input tam eşleşmeleri olmayabilir. Bu değerler, FormattableText.text öğesinin Unicode karakter ofsetleridir. Aralıkların, artan ofset değerlerine göre sıralanacağı garanti edilir.
text
Tür:  string
Olduğu gibi kullanılabilecek veya FormattableText.matches ile biçimlendirilmiş metin.