Autocomplete Data (new)

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.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
Parametreler: 
İade Değeri:  Promise<{suggestions:Array<AutocompleteSuggestion>}>
Otomatik tamamlama önerileri listesini getirir.

İsteğe AutocompleteRequest.sessionToken sağlanırsa bu oturum jetonu, Place.fetchFields ilk kez çağrıldığında, sonuçtaki PlacePrediction'lerde PlacePrediction.toPlace tarafından döndürülen her Place için otomatik olarak eklenir.
placePrediction
Tür:  PlacePrediction optional
Döndürülen sonucun okunabilir adını içerir. Kuruluş sonuçlarında bu genellikle işletme adı ve adresidir.

Bu AutocompleteSuggestion'ı getirmek için kullanılan AutocompleteRequest'te bir AutocompleteRequest.sessionToken sağlanmışsa PlacePrediction.toPlace'e yapılan bir çağrı tarafından döndürülen Place üzerinde ilk kez Place.fetchFields çağrılırken aynı jeton otomatik olarak eklenir.

AutocompleteRequest arayüzü

google.maps.places.AutocompleteRequest arayüz

AutocompleteSuggestion.fetchAutocompleteSuggestions için istek arayüzü.
input
Tür:  string
Arama yapılacak metin dizesi.
includedPrimaryTypes optional
Tür:  Array<string> optional
Birincil Yer türü (örneğin, "restaurant" veya "gas_station") dahil edilmelidir.

Bir yer yalnızca birincil türü bu listede yer alıyorsa döndürülür. En fazla 5 değer belirtilebilir. Tür belirtilmezse tüm yer türleri döndürülür.
includedRegionCodes optional
Tür:  Array<string> optional
Yalnızca belirtilen bölgelerdeki sonuçları dahil edin. En fazla 15 CLDR iki karakterli bölge kodu belirtilebilir. Boş bir küme sonuçları kısıtlamaz. Hem locationRestriction hem de includedRegionCodes ayarlanırsa sonuçlar kesişim alanında yer alır.
inputOffset optional
Tür:  number optional
input içindeki imleç konumunu gösteren, sıfır tabanlı bir Unicode karakteri uzaklığıdır.input İmleç konumu, hangi tahminlerin döndürüleceğini etkileyebilir. Belirtilmezse varsayılan olarak input uzunluğu kullanılır.
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 içinde kullanılan dil language dilinden farklıysa veya döndürülen yerin yerel dilden language diline çevirisi yoksa sonuçlar farklı dillerde olabilir.
locationBias optional
Tür:  LocationBias optional
Sonuçları belirli bir konuma göre yönlendirme

En fazla bir locationBias veya locationRestriction ayarlanmalıdır. İkisi de ayarlanmamışsa sonuçlar IP adresine göre yanlı olur. Yani IP adresi, kesin olmayan bir konumla eşlenir ve yanlılık sinyali olarak kullanılır.
locationRestriction optional
Tür:  LocationRestriction optional
Sonuçları belirtilen bir konumla sınırlandırın.

En fazla bir locationBias veya locationRestriction ayarlanmalıdır. İkisi de ayarlanmamışsa sonuçlar IP adresine göre yanlı olur. Yani IP adresi, kesin olmayan bir konumla eşlenir ve yanlılık 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
CLDR iki karakterli bölge kodu olarak belirtilen bölge kodu. Bu durum, adres biçimlendirmesini ve sonuç sıralamasını etkiler. Ayrıca, hangi sonuçların döndürüleceğini de 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 üzerinden yeni bir oturum jetonu oluşturun.

Oturum, kullanıcının sorgu yazmaya başlamasıyla başlar, bir yer seçip Place.fetchFields'ı aramasıyla sona erer. Her oturumda birden fazla sorgu olabilir ve ardından bir fetchFields çağrısı yapılır. Bir oturumdaki her istek için kullanılan kimlik bilgileri aynı Google Cloud Console projesine ait olmalıdır. Bir oturum sona erdiğinde jeton geçerliliğini kaybeder. 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, oturum jetonu sağlanmamış gibi ücretlendirilir (her istek ayrı olarak faturalandırılır).

AutocompleteSuggestion.fetchAutocompleteSuggestions isteğinde bir oturum jetonu sağlandığında, sonuçtaki AutocompleteSuggestion'lerden birinde PlacePrediction.toPlace çağrılarak döndürülen bir Place üzerinde fetchFields için yapılan ilk çağrıya aynı jeton otomatik olarak dahil edilir.

Aşağıdaki yönergeleri uygulamanızı öneririz:
  • Tüm Yer Otomatik Tamamlama çağrıları için oturum jetonlarını 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ı jetonu birden fazla oturumda kullanırsanız her istek ayrı ayrı faturalandırılır.

AutocompleteSessionToken sınıfı

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

Bir otomatik tamamlama oturumunu izlemek için kullanılan oturum jetonunu temsil eder.

const {AutocompleteSessionToken} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
AutocompleteSessionToken
AutocompleteSessionToken()
Parametreler: Yok
AutocompleteSessionToken için yeni bir örnek oluşturur.

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.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
distanceMeters
Tür:  number optional
origin belirtilmişse origin konumundan itibaren jeodezik uzunluğu metre cinsinden.
mainText
Tür:  FormattableText optional
Yerin adını gösterir.
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 ayrıntılı olarak tanımlamak için ek netleştirici özellikleri (ör. şehir veya bölge) temsil eder.
text
Döndürülen sonucun okunabilir adını içerir. Kuruluş sonuçlarında bu genellikle işletme adı ve adresidir.

text, tek bir kullanıcı arayüzü öğesi göstermek isteyen geliştiriciler için önerilir. İki ayrı ancak ilişkili kullanıcı arayüzü öğesi göstermek isteyen geliştiriciler bunun yerine PlacePrediction.mainText ve PlacePrediction.secondaryText kullanabilir.
types
Tür:  Array<string>
https://developers.google.com/maps/documentation/places/web-service/place-types adresindeki A veya B tablosunda bu Yer için geçerli olan türlerin listesi.
BetafetchAddressValidation
fetchAddressValidation(request)
Parametreler: 
İade Değeri:  Promise<AddressValidation>
Bu otomatik tamamlama oturumuyla ilişkili bir Adres Doğrulama isteği gönderir (isteği otomatik tamamlama oturumu jetonuyla dahili olarak doldurur). PlacePrediction'dan alınan yer bilgileri otomatik olarak eklenmez. Bu, otomatik tamamlama oturumu yönetimine yardımcı olan bir kolaylık yöntemidir.
toPlace
toPlace()
Parametreler: Yok
İade Değeri:  Place
Bu PlacePrediction'ın Place gösterimini döndürür. Tam yer ayrıntılarını almak için Place.fetchFields'a sonraki bir çağrı yapılması gerekir.

Bu PlacePrediction'ı getirmek için kullanılan AutocompleteRequest içinde bir AutocompleteRequest.sessionToken sağlanmışsa fetchFields çağrılırken aynı jeton otomatik olarak eklenir.

Alternatif olarak, PlacePrediction.toPlace tarafından döndürülen bir Place üzerinde Place.fetchFields için PlaceAutocompleteElement ilk görüşmesi kullanıldığında oturum jetonu otomatik olarak eklenir.

StringRange class

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

Belirli bir metindeki alt dizeyi tanımlar.

const {StringRange} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişebilirsiniz.
Maps 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 sıfır tabanlı uzaklığı (dahil).

FormattableText sınıfı

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

Yer tahmini gösteren metin. Metin olduğu gibi kullanılabilir veya biçimlendirilebilir.

const {FormattableText} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişebilirsiniz.
Maps 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 belirli bölümlerini biçimlendirmek için kullanılabilir. Eşleşme, dize eşleşmesi dışındaki ölçütlere (ör. yazım düzeltmeleri veya çeviri yazılar) göre belirlendiyse alt dizeler AutocompleteRequest.input ile tam olarak eşleşmeyebilir. Bu değerler, FormattableText.text Unicode karakter ofsetleridir. Aralıkların, artan uzaklık değerlerine göre sıralanacağı garanti edilir.
text
Tür:  string
Olduğu gibi kullanılabilecek veya FormattableText.matches ile biçimlendirilebilecek metin.