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");
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
Parametreler:
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.
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ü.
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ı
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");
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");
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
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.
BetafetchAddressValidation
fetchAddressValidation(request)
Parametreler:
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");
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");
matches
readonly
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.