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). Aşağıdaki yönergeleri uygulamanızı öneririz:
|
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. |
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:
İade Değeri:
Promise<{suggestions:Array<AutocompleteSuggestion>}> Otomatik tamamlama önerileri listesini getirir. |
Ö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. |
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 | |
---|---|
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. |
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. |