Places Service

PlacesService sınıfı

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

Yer arama ve bir yerle ilgili ayrıntıları alma yöntemlerini içerir.

const {PlacesService} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
PlacesService
PlacesService(attrContainer)
Parametreler: 
Belirtilen kapsayıcıda ilişkilendirmeleri oluşturacak PlacesService öğesinin yeni bir örneğini oluşturur.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
Parametreler: 
Döndürülen Değer: Yok
Telefon numarasına göre yerlerin listesini alır. Çoğu durumda sonuç listesinde yalnızca bir öğe bulunur. Ancak istek belirsizse birden fazla sonuç döndürülebilir. Geri çağırmaya iletilen PlaceResult'ler, tam bir PlaceResult'nin alt kümeleridir. Uygulamanız, PlacesService.getDetails işlevini çağırıp istenen yer için PlaceResult.place_id değerini ileterek her yer için daha ayrıntılı bir PlaceResult alabilir.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
Parametreler: 
Döndürülen Değer: Yok
Bir sorgu dizesine göre yerlerin listesini alır. Çoğu durumda sonuç listesinde yalnızca bir öğe bulunur. Ancak istek belirsizse birden fazla sonuç döndürülebilir. Geri çağırmaya iletilen PlaceResult'ler, tam bir PlaceResult'nin alt kümeleridir. Uygulamanız, PlacesService.getDetails işlevini çağırıp istenen yer için PlaceResult.place_id değerini ileterek her yer için daha ayrıntılı bir PlaceResult alabilir.
getDetails
getDetails(request, callback)
Parametreler: 
Döndürülen Değer: Yok
Belirtilen placeId ile tanımlanan yerle ilgili ayrıntıları alır.
nearbySearch
nearbySearch(request, callback)
Parametreler: 
Döndürülen Değer: Yok
Anahtar kelimeye veya türe göre, belirli bir konumun yakınındaki yerlerin listesini alır. Konum her zaman belirtilmelidir. Bu işlem, LatLngBounds veya location ve radius parametreleri iletilek yapılabilir. Geri çağırmaya iletilen PlaceResult'ler, tam PlaceResult'nin alt kümeleridir. Uygulamanız, istenen yer için PlaceResult.place_id değerini ileten bir Yer Ayrıntıları isteği göndererek her yer için daha ayrıntılı bir PlaceResult alabilir. PlaceSearchPagination nesnesi, ek sonuç sayfalarını getirmek için kullanılabilir (sonuçların son sayfasıysa veya yalnızca bir sonuç sayfası varsa null).
textSearch
textSearch(request, callback)
Parametreler: 
Döndürülen Değer: Yok
Sorgu dizesine göre (örneğin, "New York'ta pizza" veya "Ankara yakınlarındaki ayakkabı mağazaları") yerlerin listesini alır. Konum parametreleri isteğe bağlıdır. Konum belirtildiğinde sonuçlar, bölge içindeki yerlerle sınırlanmak yerine yalnızca yakındaki sonuçlara yönlendirilir. Yerleri rastgele bir dize kullanarak aramak istediğinizde ve arama sonuçlarını belirli bir konumla sınırlamak istemediğiniz durumlarda textSearch kullanın. PlaceSearchPagination nesnesi, ek sonuç sayfalarını getirmek için kullanılabilir (sonuçların son sayfasıysa veya yalnızca bir sonuç sayfası varsa null).

PlaceDetailsRequest arayüzü

google.maps.places.PlaceDetailsRequest arayüz

PlacesService adresine gönderilecek bir yer ayrıntıları sorgusu.
placeId
Tür:  string
Ayrıntıları istenen yerin yer kimliği.
fields optional
Tür:  Array<string> optional
Ayrıntılar yanıtına dahil edilecek alanlar için faturalandırma yapılır. Alan belirtilmemişse veya ['ALL'] iletilirse kullanılabilir tüm alanlar döndürülür ve bunlar için faturalandırma yapılır (bu, üretim dağıtımları için önerilmez). Alanların listesi için PlaceResult adresini ziyaret edin. İç içe yerleştirilmiş alanlar nokta yollarıyla (örneğin, "geometry.location") belirtilebilir.
language optional
Tür:  string optional
Ayrıntıların döndürülmesi gereken dilin dil tanımlayıcısı. Desteklenen dillerin listesine bakın.
region optional
Tür:  string optional
Kullanıcının bölgesinin bölge kodu. Bu durum, hangi fotoğrafların döndürüleceğini ve muhtemelen başka şeyleri etkileyebilir. Bölge kodu, ccTLD ("üst düzey alan") iki karakterlik değerini kabul eder. Çoğu ccTLD kodu, ISO 3166-1 kodlarıyla aynıdır ancak bazı önemli istisnalar vardır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk), ISO 3166-1 kodu ise "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" için).
sessionToken optional
Tür:  AutocompleteSessionToken optional
Ayrıntılar isteğini bir otomatik tamamlama oturumuyla paketlemek için kullanılan benzersiz referans.

FindPlaceFromPhoneNumberRequest arayüzü

google.maps.places.FindPlaceFromPhoneNumberRequest arayüz

PlacesService.findPlaceFromPhoneNumber adresine gönderilecek bir metin arama isteğinden yer bulma.
fields
Tür:  Array<string>
Yanıtın içinde yer alacak ve ücretlendirilecek alanlar. ['ALL'] iletilirse tüm kullanılabilir alanlar döndürülür ve bunlar için faturalandırma yapılır (bu, üretim dağıtımları için önerilmez). Alanların listesi için PlaceResult adresini ziyaret edin. İç içe yerleştirilmiş alanlar nokta yollarıyla (örneğin, "geometry.location") belirtilebilir.
phoneNumber
Tür:  string
Aranacak yerin telefon numarası. Biçim E.164 olmalıdır.
language optional
Tür:  string optional
Mümkün olduğunda adların ve adreslerin döndürülmesi gereken dilin dil tanımlayıcısı. Desteklenen dillerin listesine bakın.
locationBias optional
Tür:  LocationBias optional
Yer ararken kullanılan önyargı. Sonuç, verilen LocationBias öğesine yönelik önyargılı olacak ancak bununla sınırlı olmayacak.

FindPlaceFromQueryRequest arayüzü

google.maps.places.FindPlaceFromQueryRequest arayüz

PlacesService.findPlaceFromQuery adresine gönderilecek bir metin arama isteğinden yer bulma.
fields
Tür:  Array<string>
Yanıtın içinde yer alacak ve ücretlendirilecek alanlar. ['ALL'] iletilirse tüm kullanılabilir alanlar döndürülür ve bunlar için faturalandırma yapılır (bu, üretim dağıtımları için önerilmez). Alanların listesi için PlaceResult adresini ziyaret edin. İç içe yerleştirilmiş alanlar nokta yollarıyla (örneğin, "geometry.location") belirtilebilir.
query
Tür:  string
İsteğin sorgusu. Örneğin, bir yerin adı veya adresi.
language optional
Tür:  string optional
Mümkün olduğunda adların ve adreslerin döndürülmesi gereken dilin dil tanımlayıcısı. Desteklenen dillerin listesine bakın.
locationBias optional
Tür:  LocationBias optional
Yer ararken kullanılan önyargı. Sonuç, verilen LocationBias öğesine yönelik önyargılı olacak ancak bununla sınırlı olmayacak.

PlaceSearchRequest arayüzü

google.maps.places.PlaceSearchRequest arayüz

PlacesService'a gönderilecek bir Yer arama sorgusu.
bounds optional
Yerlerin aranacağı sınırlar. bounds ayarlanırsa hem location hem de radius yoksayılır.
keyword optional
Tür:  string optional
Ad, tür ve adresin yanı sıra müşteri yorumları ve diğer üçüncü taraf içerikleri dahil ancak bunlarla sınırlı olmamak üzere, mevcut tüm alanlarla eşleştirilecek bir terim.
language optional
Tür:  string optional
Mümkün olduğunda adların ve adreslerin döndürülmesi gereken dilin dil tanımlayıcısı. Desteklenen dillerin listesine bakın.
location optional
Tür:  LatLng|LatLngLiteral optional
Yer aramak için kullanılacak konum.
maxPriceLevel optional
Tür:  number optional
Sonuçları yalnızca belirtilen fiyat düzeyindeki veya daha düşük fiyat düzeyindeki yerlerle sınırlar. Geçerli değerler 0 (en uygun fiyatlı) ile 4 (en pahalı) aralığındadır (bu değerler dahil). Belirtilmişse minPrice değerine eşit veya daha büyük olmalıdır.
minPriceLevel optional
Tür:  number optional
Sonuçları yalnızca belirtilen fiyat düzeyinde veya daha yüksek fiyat düzeyindeki yerlerle sınırlandırır. Geçerli değerler 0 (en uygun fiyatlı) ile 4 (en pahalı) aralığındadır (bu değerler dahil). Belirtilmişse maxPrice değerinden küçük veya bu değere eşit olmalıdır.
name optional
Tür:  string optional
keyword etiketine eş değer. Bu alandaki değerler, keyword alanındaki değerlerle birleştirilir ve aynı arama dizesinin bir parçası olarak iletilir.
openNow optional
Tür:  boolean optional
Sonuçları yalnızca şu anda açık olan yerlerle sınırlar.
radius optional
Tür:  number optional
Belirli bir konumdan itibaren yer aranacak mesafe (metre cinsinden). İzin verilen maksimum değer 50.000'dir.
rankBy optional
Tür:  RankBy optional
Varsayılan: RankBy.PROMINENCE
Sonuç döndürülürken kullanılacak sıralama yöntemini belirtir. rankBy, DISTANCE olarak ayarlandığında location belirtmeniz gerektiğini ancak radius veya bounds belirtemeyeceğinizi unutmayın.
type optional
Tür:  string optional
Belirtilen türdeki yerleri arar. Tür, isteğin hedef konumunun yerel diline çevrilir ve sorgu dizesi olarak kullanılır. Bir sorgu da sağlanırsa yerelleştirilmiş tür dizesine eklenir. Farklı türdeki sonuçlar yanıttan çıkarılır. Bu alanı, dil ve bölgeden bağımsız kategorik aramalar yapmak için kullanın. Geçerli türler burada verilmiştir.

TextSearchRequest arayüzü

google.maps.places.TextSearchRequest arayüz

PlacesService adresine gönderilecek bir metin arama isteği.
bounds optional
Yer ararken sonuçları etkilemek için kullanılan sınırlar (isteğe bağlı). bounds ayarlanırsa hem location hem de radius yoksayılır. Sonuçlar bu sınırlar içindekilerle sınırlı olmasa da bu sınırlar içindeki sonuçlar daha üst sıralarda yer alır.
language optional
Tür:  string optional
Mümkün olduğunda adların ve adreslerin döndürülmesi gereken dilin dil tanımlayıcısı. Desteklenen dillerin listesine bakın.
location optional
Tür:  LatLng|LatLngLiteral optional
Yer ararken sonuçları etkilemek için kullanılan alanın merkezi.
query optional
Tür:  string optional
İsteğin sorgu terimi. Örneğin, bir yerin adı ("Eyfel Kulesi"), bir kategori ve ardından bir konumun adı ("New York'ta pizza") veya bir yerin adı ve ardından bir konum netleştiricisi ("Sidney'deki Starbucks").
radius optional
Tür:  number optional
Yer ararken sonuçları etkilemek için kullanılan alanın yarıçapı (metre cinsinden).
region optional
Tür:  string optional
Sonuçları belirli bir bölgeye yönlendirmek için kullanılan bölge kodu. Bölge kodu, ccTLD ("üst düzey alan") iki karakterlik değerini kabul eder. Çoğu ccTLD kodu, ISO 3166-1 kodlarıyla aynıdır ancak bazı önemli istisnalar vardır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk), ISO 3166-1 kodu ise "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" için).
type optional
Tür:  string optional
Belirtilen türdeki yerleri arar. Tür, isteğin hedef konumunun yerel diline çevrilir ve sorgu dizesi olarak kullanılır. Bir sorgu da sağlanırsa yerelleştirilmiş tür dizesine eklenir. Farklı türdeki sonuçlar yanıttan çıkarılır. Bu alanı, dil ve bölgeden bağımsız kategorik aramalar yapmak için kullanın. Geçerli türler burada verilmiştir.

RankBy sabitleri

google.maps.places.RankBy sabitler

PlaceSearchRequest için sıralama seçenekleri.

const {RankBy} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
DISTANCE Yer sonuçlarını konuma olan mesafeye göre sıralar.
PROMINENCE Yer sonuçlarını önemlerine göre sıralar.

LocationBias typedef

google.maps.places.LocationBias typedef

LocationBias, Yerler aranırken kullanılacak yumuşak bir sınırı veya ipucunu temsil eder. Sonuçlar, belirtilen alanın dışından gelebilir. Mevcut kullanıcının IP adresini önyargı olarak kullanmak için "IP_BIAS" dizesi belirtilebilir. Not: Circle kullanılıyorsa merkez ve yarıçap tanımlanmalıdır.

LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string

LocationRestriction typedef

google.maps.places.LocationRestriction typedef

LocationRestriction, Yerler aranırken kullanılacak katı bir sınırı temsil eder.

LatLngBounds|