Autocomplete Data

AutocompleteSuggestion sınıfı

google.maps.places.AutocompleteSuggestion sınıf
kitaplık "places"

Otomatik tamamlama önerisi sonucu.

const {AutocompleteSuggestion} = await google.maps.importLibrary("places");

Statik Yöntemler

fetchAutocompleteSuggestions

fetchAutocompleteSuggestions(autocompleteRequest) Parametreler: autocompleteRequest: AutocompleteRequest Dönüş Değeri: Promise<{suggestions:Array<AutocompleteSuggestion>}> AutocompleteSuggestions listesini getirir. İstekte bir AutocompleteRequest.sessionToken sağlanırsa bu oturum jetonu, sonuçta elde edilen PlacePrediction nesnelerinde PlacePrediction.toPlace tarafından döndürülen her Place için Place.fetchFields ilk kez çağrıldığında otomatik olarak dahil edilir.

Özellikler

placePrediction readonly

Tür: PlacePrediction optional Döndürülen sonucun kullanıcı tarafından okunabilen adını içerir. Kuruluş sonuçları için bu genellikle işletme adı ve adresidir. Bu AutocompleteSuggestion'ı getirmek için kullanılan AutocompleteRequest'te bir AutocompleteRequest.sessionToken sağlanmışsa PlacePrediction.toPlace çağrısı tarafından döndürülen Place üzerinde Place.fetchFields ilk kez çağrılırken aynı jeton otomatik olarak dahil edilir.

AutocompleteRequest arayüzü

google.maps.places.AutocompleteRequest arayüz

AutocompleteSuggestion.fetchAutocompleteSuggestions için istek arayüzü.

Özellikler
input	Tür: string Aranacak metin dizesi.
futureOpeningBusinessesIncluded isteğe bağlı	Tür: boolean optional Henüz açılmamış ancak gelecekte açılması beklenen işletmeler için yer tahminlerini dahil edin.
includedPrimaryTypes isteğe bağlı	Tür: Array<string> optional Dahil edilen birincil yer türü (örneğin, "restaurant" veya "gas_station"). Bir yer, yalnızca birincil türü bu listede yer alıyorsa döndürülür. En fazla 5 değer belirtilebilir. Hiçbir tür belirtilmezse tüm yer türleri döndürülür.
includedRegionCodes isteğe bağlı	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 isteğe bağlı	Tür: number optional input içinde imleç konumunu gösteren, sıfır tabanlı bir Unicode karakter ofseti (input). İmlecin konumu, döndürülen tahminleri etkileyebilir. Belirtilmezse varsayılan olarak input uzunluğuna ayarlanır.
language isteğe bağlı	Tür: string optional Sonuçların döndürüleceği dil. Varsayılan olarak tarayıcının dil tercihi kullanılı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 dillerde olabilir.
locationBias isteğe bağlı	Tür: LocationBias optional Sonuçları belirli bir konuma göre önceliklendirme locationBias veya locationRestriction değerlerinden en fazla biri ayarlanmalıdır. İkisi de ayarlanmazsa sonuçlar IP adresine göre yanlı olur. Yani IP adresi, kesin olmayan bir konuma eşlenir ve yanlılık sinyali olarak kullanılır.
locationRestriction isteğe bağlı	Tür: LocationRestriction optional Sonuçları belirtilen bir konumla kısıtlar. locationBias veya locationRestriction değerlerinden en fazla biri ayarlanmalıdır. İkisi de ayarlanmazsa sonuçlar IP adresine göre yanlı olur. Yani IP adresi, kesin olmayan bir konuma eşlenir ve yanlılık sinyali olarak kullanılır.
origin isteğe bağlı	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.
pureServiceAreaBusinessesIncluded isteğe bağlı	Tür: boolean optional Alan "true" olarak ayarlanmışsa salt hizmet bölgesi işletmelerini dahil edin. Salt hizmet bölgesi işletmesi, müşterileri doğrudan ziyaret eden veya onlara teslimat yapan ancak işletme adresinde müşterilere hizmet vermeyen işletmelerdir. Örneğin, temizlik veya tesisat hizmeti sunan işletmelerin Google Haritalar'da fiziksel adresi veya konumu olmayabilir.
region isteğe bağlı	Tür: string optional CLDR iki karakterli bölge kodu olarak belirtilen bölge kodu. Bu, adres biçimlendirmesini ve sonuç sıralamasını etkiler. Ayrıca, döndürülen sonuçları da etkileyebilir. Bu, sonuçları belirtilen bölgeyle kısıtlamaz.
sessionToken isteğe bağlı	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ı bir sorgu yazmaya başladığında başlar ve bir yer seçip Place.fetchFields yöntemini çağırdığı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 erdikten sonra jeton artık geçerli olmaz. 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, aynı jeton, sonuçta elde edilen AutocompleteSuggestion'lerden birinde PlacePrediction.toPlace çağrılarak döndürülen bir Place üzerinde fetchFields'e yapılan ilk çağrıya otomatik olarak dahil edilir. Aşağıdaki yönergeleri uygulamanızı öneririz: Tüm Yer Adı Otomatik 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ı ayrı faturalandırılmasına neden olur.

AutocompleteSessionToken sınıfı

google.maps.places.AutocompleteSessionToken sınıf
kitaplık "places"

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

const {AutocompleteSessionToken} = await google.maps.importLibrary("places");

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

PlacePrediction sınıfı

google.maps.places.PlacePrediction sınıf
kitaplık "places"

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

const {PlacePrediction} = await google.maps.importLibrary("places");

Özellikler
distanceMeters readonly	Tür: number optional origin belirtilmişse origin noktasından itibaren jeodeziğin metre cinsinden uzunluğu.
mainText readonly	Tür: FormattableText optional Yerin adını temsil eder.
placeId readonly	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 readonly	Tür: FormattableText optional Yeri daha ayrıntılı bir şekilde tanımlamak için ek anlam belirsizliğini giderme özelliklerini (ör. şehir veya bölge) temsil eder.
text readonly	Tür: FormattableText Döndürülen sonucun kullanıcı tarafından okunabilen adını içerir. Kuruluş sonuçları için 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 ilgili kullanıcı arayüzü öğesi göstermek isteyen geliştiriciler bunun yerine PlacePrediction.mainText ve PlacePrediction.secondaryText kullanabilir.
types readonly	Tür: Array<string> https://developers.google.com/maps/documentation/places/web-service/place-types adresindeki Tablo A veya Tablo B'den bu yer için geçerli olan türlerin listesi.

Yöntemler
fetchAddressValidation	Not: Yalnızca v=beta kanalında kullanılabilir. fetchAddressValidation(request) Parametreler: request: AddressValidationRequest Dönüş Değeri: Promise<AddressValidation> Bu otomatik tamamlama oturumuyla ilişkili bir Address Validation isteği gönderir (isteği otomatik tamamlama oturum jetonuyla dahili olarak doldurur). PlacePrediction'dan alınan yer bilgileri otomatik olarak dahil edilmez. Bu, otomatik tamamlama oturum yönetimine yardımcı olan kullanışlı bir yöntemdir.
toPlace	toPlace() Parametreler: Yok Dönüş Değeri: Place Bu PlacePrediction'ın Place temsilini döndürür. Yer ayrıntılarının tamamını almak için Place.fetchFields yöntemine yönelik bir çağrı daha yapılması gerekir. Bu PlacePrediction'ı getirmek için kullanılan AutocompleteRequest içinde bir AutocompleteRequest.sessionToken sağlandıysa fetchFields çağrılırken aynı jeton otomatik olarak dahil edilir. Alternatif olarak, PlaceAutocompleteElement kullanırken PlacePrediction.toPlace tarafından döndürülen bir Place üzerinde Place.fetchFields için yapılan ilk çağrı, oturum jetonunu otomatik olarak içerir.

StringRange sınıfı

google.maps.places.StringRange sınıf
kitaplık "places"

Belirli bir metindeki alt dizeyi tanımlar.

const {StringRange} = await google.maps.importLibrary("places");

Özellikler
endOffset readonly	Tür: number Alt dizenin son Unicode karakterinin sıfır tabanlı ofseti (hariç).
startOffset readonly	Tür: number Alt dizenin ilk Unicode karakterinin sıfır tabanlı ofseti (dahil).

FormattableText sınıfı

google.maps.places.FormattableText sınıf
kitaplık "places"

Yer tahminini temsil eden metin. Metin olduğu gibi veya biçimlendirilerek kullanılabilir.

const {FormattableText} = await google.maps.importLibrary("places");

Özellikler
matches readonly	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 öğesinin belirli bölümlerini biçimlendirmek için kullanılabilir. Eşleşme, dize eşleme dışındaki ölçütlere (ör. yazım düzeltmeleri veya harf çevirileri) göre belirlendiyse alt dizeler AutocompleteRequest.input ile tam olarak eşleşmeyebilir. Bu değerler, FormattableText.text öğesinin Unicode karakter ofsetleridir. Aralıkların, artan ofset değerlerine göre sıralanması garanti edilir.
text readonly	Tür: string Olduğu gibi kullanılabilen veya FormattableText.matches ile biçimlendirilebilen metin.