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.

Statik Yöntemler

fetchAutocompleteSuggestions

fetchAutocompleteSuggestions(autocompleteRequest) Parametreler:  autocompleteRequest:  AutocompleteRequest İ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.

Özellikler

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

Özellikler
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.

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

Özellikler
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	Tür:  FormattableText 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.

Yöntemler
fetchAddressValidation	Uyarı: Yalnızca v=beta kanalında kullanılabilir. fetchAddressValidation(request) Parametreler:  request:  AddressValidationRequest Döndürülen Değer: Yok 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.

Özellikler
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.

Özellikler
matches	Tür:  Array<StringRange> 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.