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|LatLngAltitude|LatLngAltitudeLiteral|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|LatLngBoundsLiteral

PlacesServiceStatus sabitleri

google.maps.places.PlacesServiceStatus sabitler

Aramaları tamamlandığında PlacesService tarafından döndürülen durum. Bunları değerle veya sabitin adını kullanarak belirtebilirsiniz. Örneğin, 'OK' veya google.maps.places.PlacesServiceStatus.OK

const {PlacesServiceStatus} = await google.maps.importLibrary("places") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
INVALID_REQUEST Bu istek geçersizdi.
NOT_FOUND Başvuruda bulunulan yer bulunamadı.
OK Yanıtta geçerli bir sonuç var.
OVER_QUERY_LIMIT Uygulama, istek kotasını aştı.
REQUEST_DENIED Uygulamanın PlacesService kullanmasına izin verilmiyor.
UNKNOWN_ERROR PlacesService isteği, sunucu hatası nedeniyle işlenemedi. Tekrar denerseniz istek başarılı olabilir.
ZERO_RESULTS Bu istek için sonuç bulunamadı.

PlaceSearchPagination arayüzü

google.maps.places.PlaceSearchPagination arayüz

Yer sonuçlarının ek sayfalarını getirmek için kullanılan bir nesne.
hasNextPage
Tür:  boolean
Başka sonuçların olup olmadığını belirtir. true ek bir sonuç sayfası olduğunda
nextPage
nextPage()
Parametreler: Yok
İade Değeri:  void
Sonraki sonuç sayfasını getirir. İlk arama isteğine sağlanan geri çağırma işlevini kullanır.

PlaceResult arayüzü

google.maps.places.PlaceResult arayüz

Bir yer hakkındaki bilgileri tanımlar.
address_components optional
Bu yerin konumuna ait adres bileşenleri koleksiyonu. Yalnızca PlacesService.getDetails ile kullanılabilir.
adr_address optional
Tür:  string optional
adr mikro biçiminde yerin adresinin gösterimi. Yalnızca PlacesService.getDetails ile kullanılabilir.
aspects optional
Tür:  Array<PlaceAspectRating> optional
Google ve Zagat kullanıcı yorumlarına göre bu yerin puanlanan yönleri. Puanlar 0 ile 30 arasında bir ölçekte verilir.
business_status optional
Tür:  BusinessStatus optional
İşletme ise yerin operasyonel durumunu gösteren bir işaret (yerin operasyonel olup olmadığını veya geçici ya da kalıcı olarak kapalı olup olmadığını gösterir). Veri yoksa arama veya ayrıntı yanıtlarında işaret bulunmaz.
formatted_address optional
Tür:  string optional
Yerin tam adresi.
formatted_phone_number optional
Tür:  string optional
Yer'in numaranın bölgesel kuralına göre biçimlendirilmiş telefon numarası. Yalnızca PlacesService.getDetails ile kullanılabilir.
geometry optional
Tür:  PlaceGeometry optional
Yerin geometriyle ilgili bilgileri.
html_attributions optional
Tür:  Array<string> optional
Bu yer sonucu için gösterilecek kaynak bilgisi metni. İstenen fields'lerden bağımsız olarak her zaman kullanılabilir html_attributions döndürülür ve bunlar gösterilmelidir.
icon optional
Tür:  string optional
Bu yerin kategorisini temsil etmek için kullanılabilecek bir resim kaynağının URL'si.
icon_background_color optional
Tür:  string optional
Bir yerin simgesiyle kullanılacak arka plan rengi. Ayrıca PlaceResult.icon_mask_base_uri başlıklı makaleyi inceleyin.
icon_mask_base_uri optional
Tür:  string optional
Bir simge maskesinin kısaltılmış URL'si. Dosya uzantısını sona ekleyerek farklı simge türlerine erişin (ör. .svg veya .png).
international_phone_number optional
Tür:  string optional
Yerin uluslararası standarttaki telefon numarası. Uluslararası biçim, ülke kodunu içerir ve artı (+) işaretiyle başlar. Yalnızca PlacesService.getDetails ile kullanılabilir.
name optional
Tür:  string optional
Yerin adı. Not: Kullanıcı tarafından girilen yerlerde bu, kullanıcının yazdığı ham metindir. Kötü niyetli kullanıcılar bu verileri kod yerleştirme saldırıları için bir vektör olarak kullanmaya çalışabileceğinden (bkz. http://en.wikipedia.org/wiki/Code_injection), lütfen bu verileri kullanırken dikkatli olun.
opening_hours optional
Tür:  PlaceOpeningHours optional
Mekanın açılış veya kapanış saatini tanımlar.
permanently_closed optional
Tür:  boolean optional
Yerin kalıcı veya geçici olarak kapalı olup olmadığını gösteren işaret. Yer açıksa veya veri yoksa yanıtta işaret bulunmaz.
photos optional
Tür:  Array<PlacePhoto> optional
Bu yerin fotoğrafları Koleksiyonda en fazla on PlacePhoto nesne bulunur.
place_id optional
Tür:  string optional
Yer için benzersiz tanımlayıcı.
plus_code optional
Tür:  PlacePlusCode optional
Yer için Açık Konum Kodları veya "plus code" tanımlar.
price_level optional
Tür:  number optional
Yerin 0 ile 4 arasında değişen fiyat düzeyi. Fiyat düzeyleri şu şekilde yorumlanır:
  • 0: Ücretsiz
  • 1: Ucuz
  • 2: Orta
  • 3: Pahalı
  • 4: Çok Pahalı
rating optional
Tür:  number optional
Bu yerle ilgili kullanıcı yorumlarına dayalı olarak 1, 0 ile 5, 0 arasında bir puan.
reviews optional
Tür:  Array<PlaceReview> optional
Bu yerle ilgili yorumların listesi. Yalnızca PlacesService.getDetails ile kullanılabilir.
types optional
Tür:  Array<string> optional
Bu yerin türleri dizisi (ör. ["political", "locality"] veya ["restaurant", "establishment"]).
url optional
Tür:  string optional
Bu yerin resmi Google sayfasının URL'si. Bu, Yer hakkında mevcut en iyi bilgileri içeren ve Google'a ait olan sayfadır. Yalnızca PlacesService.getDetails ile kullanılabilir.
user_ratings_total optional
Tür:  number optional
Bu yerin PlaceResult.rating puanına katkıda bulunan kullanıcı puanlarının sayısı.
utc_offset optional
Tür:  number optional
Yer'in mevcut saat diliminin UTC'den farkı (dakika cinsinden). Örneğin, Avustralya'daki Sidney, yaz saati uygulamasında UTC'den 11 saat ileridedir. Bu nedenle utc_offset, 660 olur. UTC'nin gerisinde olan saat dilimlerinde fark negatiftir. Örneğin, Yeşil Burun Adaları'nda utc_offset, -60'dir. Yalnızca PlacesService.getDetails ile kullanılabilir.
utc_offset_minutes optional
Tür:  number optional
Yer'in mevcut saat diliminin UTC'den farkı (dakika cinsinden). Örneğin, Avustralya'daki Sidney, yaz saati uygulamasında UTC'den 11 saat ileridedir. Bu nedenle utc_offset_minutes, 660 olur. UTC'nin gerisinde olan saat dilimlerinde fark negatiftir. Örneğin, Yeşil Burun Adaları'nda utc_offset_minutes, -60'dir. Yalnızca PlacesService.getDetails ile kullanılabilir.
vicinity optional
Tür:  string optional
Yerle ilgili basitleştirilmiş adres (sokak adı, sokak numarası ve yerleşim yeri dahil ancak il/eyalet, posta kodu veya ülke hariç). Örneğin, Google'ın Sidney, Avustralya'daki ofisinin yakınlık değeri "48 Pirrama Road, Pyrmont"'dır. Yalnızca