PlacesService sınıfı
sınıf
google.maps.places.PlacesService
kitaplık "places"
Yer arama ve bir yerle ilgili ayrıntıları alma ile ilgili yöntemleri içerir.
const {PlacesService} = await google.maps.importLibrary("places");
Marka | |
|---|---|
PlacesService |
PlacesService(attrContainer)Parametreler:
Belirtilen kapsayıcıda ilişkilendirmeleri oluşturan yeni bir PlacesService örneği oluşturur. |
Yöntemler | |
|---|---|
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, tam bir PlaceResult öğesinin alt kümeleridir. Uygulamanız, PlacesService.getDetails yöntemini çağırıp istenen yerin 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
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, tam bir PlaceResult öğesinin alt kümeleridir. Uygulamanız, PlacesService.getDetails yöntemini çağırıp istenen yerin 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 LatLngBounds veya location ve radius parametreleri iletilerek belirtilmelidir. Geri çağırmaya iletilen PlaceResult, tam PlaceResult'in 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 (bu son sonuç sayfasıysa veya yalnızca bir sonuç sayfası varsa null olur). |
textSearch |
textSearch(request, callback)Parametreler:
Döndürülen değer: Yok
Bir sorgu dizesine (ör. "New York'ta pizza" veya "Ottawa yakınlarındaki ayakkabı mağazaları") göre yerlerin listesini alır. Konum parametreleri isteğe bağlıdır. Konum belirtildiğinde sonuçlar, bölge içindeki yerlerle kısıtlanmak yerine yalnızca yakındaki sonuçlara göre önceliklendirilir. Rastgele bir dize kullanarak yer 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 (bu son sonuç sayfasıysa veya yalnızca bir sonuç sayfası varsa null olur). |
PlaceDetailsRequest arayüzü
arayüz
google.maps.places.PlaceDetailsRequest
PlacesService hizmetine gönderilecek bir yer ayrıntıları sorgusu.
Özellikler | |
|---|---|
placeId |
Tür:
stringAyrıntıları istenen yerin yer kimliği. |
fields
isteğe bağlı |
Tür:
Array<string> optionalAyrıntılar yanıtına dahil edilecek alanlar (faturalandırılacak). Hiçbir alan belirtilmezse veya ['ALL'] iletilirse mevcut tüm alanlar döndürülür ve faturalandırılır (Bu, üretim dağıtımları için önerilmez). Alanların listesi için PlaceResult sayfasına bakın. İç içe yerleştirilmiş alanlar, nokta yollarıyla belirtilebilir (örneğin, "geometry.location"). |
language
isteğe bağlı |
Tür:
string optionalAyrıntıların döndürülmesi gereken dilin tanımlayıcısıdır. Desteklenen dillerin listesine bakın. |
region
isteğe bağlı |
Tür:
string optionalKullanıcının bölgesinin bölge kodu. Bu durum, hangi fotoğrafların döndürüleceğini ve muhtemelen diğer şeyleri etkileyebilir. Bölge kodu, iki karakterli bir ccTLD ("üst düzey alan") değerini kabul eder. Çoğu ccTLD kodu, bazı önemli istisnalar dışında ISO 3166-1 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" ( .co.uk) iken ISO 3166-1 kodu "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" tüzel kişiliği için). |
sessionToken
isteğe bağlı |
Tür:
AutocompleteSessionToken optionalAyrıntı isteğini bir otomatik tamamlama oturumuyla birleştirmek için kullanılan benzersiz referans. |
FindPlaceFromPhoneNumberRequest arayüzü
arayüz
google.maps.places.FindPlaceFromPhoneNumberRequest
PlacesService.findPlaceFromPhoneNumber adresine gönderilecek metin arama isteğinden yer bulma.
Özellikler | |
|---|---|
fields |
Tür:
Array<string>Yanıta dahil edilecek ve faturalandırılacak alanlar. ['ALL'] iletilirse mevcut tüm alanlar döndürülür ve faturalandırılır (Bu, üretim dağıtımları için önerilmez). Alanların listesi için PlaceResult sayfasına bakın. İç içe yerleştirilmiş alanlar, nokta yollarıyla (ör. "geometry.location") belirtilebilir. |
phoneNumber |
Tür:
stringAranacak yerin telefon numarası. Biçim E.164 olmalıdır. |
language
isteğe bağlı |
Tür:
string optionalMümkün olduğunda adların ve adreslerin döndürülmesi gereken dil için bir dil tanımlayıcısı. Desteklenen dillerin listesine bakın. |
locationBias
isteğe bağlı |
Tür:
LocationBias optionalYer ararken kullanılan ağırlık. Sonuç, belirtilen LocationBias ile sınırlı olmamakla birlikte bu değere göre ağırlıklandırılır. |
FindPlaceFromQueryRequest arayüzü
arayüz
google.maps.places.FindPlaceFromQueryRequest
PlacesService.findPlaceFromQuery adresine gönderilecek metin arama isteğinden yer bulma.
Özellikler | |
|---|---|
fields |
Tür:
Array<string>Yanıta dahil edilecek ve faturalandırılacak alanlar. ['ALL'] iletilirse mevcut tüm alanlar döndürülür ve faturalandırılır (Bu, üretim dağıtımları için önerilmez). Alanların listesi için PlaceResult sayfasına bakın. İç içe yerleştirilmiş alanlar, nokta yollarıyla belirtilebilir (örneğin, "geometry.location"). |
query |
Tür:
stringİsteğin sorgusu. Örneğin, bir yerin adı veya adresi. |
language
isteğe bağlı |
Tür:
string optionalMümkün olduğunda adların ve adreslerin döndürülmesi gereken dil için bir dil tanımlayıcısı. Desteklenen dillerin listesine bakın. |
locationBias
isteğe bağlı |
Tür:
LocationBias optionalYer ararken kullanılan ağırlık. Sonuç, belirtilen LocationBias ile sınırlı olmamakla birlikte bu değere göre ağırlıklandırılır. |
PlaceSearchRequest arayüzü
arayüz
google.maps.places.PlaceSearchRequest
PlacesService hizmetine gönderilecek bir yer arama sorgusu.
Özellikler | |
|---|---|
bounds
isteğe bağlı |
Tür:
LatLngBounds|LatLngBoundsLiteral optionalYerlerin aranacağı sınırlar. bounds ayarlanırsa hem location hem de radius yoksayılır. |
keyword
isteğe bağlı |
Tür:
string optionalAd, 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
isteğe bağlı |
Tür:
string optionalMümkün olduğunda adların ve adreslerin döndürülmesi gereken dil için bir dil tanımlayıcısı. Desteklenen dillerin listesine bakın. |
location
isteğe bağlı |
Tür:
LatLng|LatLngLiteral optionalYerlerin aranacağı konum. |
maxPriceLevel
isteğe bağlı |
Tür:
number optionalSonuçları yalnızca belirtilen fiyat düzeyindeki veya daha düşük fiyat düzeyindeki yerlerle kısıtlar. Geçerli değerler, 0 (en uygun fiyatlı) ile 4 (en pahalı) arasındadır (bu değerler dahil). Belirtilmişse minPrice veya daha büyük olmalıdır. |
minPriceLevel
isteğe bağlı |
Tür:
number optionalSonuçları yalnızca belirtilen fiyat düzeyinde veya daha yüksek olan yerlerle kısıtlar. Geçerli değerler, 0 (en uygun fiyatlı) ile 4 (en pahalı) arasındadır (bu değerler dahil). Belirtilmişse maxPrice değerinden küçük veya buna eşit olmalıdır. |
isteğe bağlı |
Tür:
string optionalkeyword 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
isteğe bağlı |
Tür:
boolean optionalSonuçları yalnızca şu anda açık olan yerlerle kısıtlar. |
radius
isteğe bağlı |
Tür:
number optionalBelirli bir konumdan itibaren yerlerin aranacağı mesafe (metre cinsinden). İzin verilen maksimum değer 50.000'dir. |
rankBy
isteğe bağlı |
Tür:
RankBy optionalVarsayılan:
RankBy.PROMINENCESonuçlar döndürülürken kullanılacak sıralama yöntemini belirtir. rankBy, DISTANCE olarak ayarlandığında location belirtmeniz gerekir ancak radius veya bounds belirtemezsiniz. |
type
isteğe bağlı |
Tür:
string optionalBelirtilen 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 dizesiyle birleştirilir. Farklı türdeki sonuçlar yanıttan çıkarılır. Dil ve bölgeden bağımsız kategorik aramalar yapmak için bu alanı kullanın. Geçerli türler burada verilmiştir. |
TextSearchRequest arayüzü
arayüz
google.maps.places.TextSearchRequest
PlacesService hizmetine gönderilecek bir metin arama isteği.
Özellikler | |
|---|---|
bounds
isteğe bağlı |
Tür:
LatLngBounds|LatLngBoundsLiteral optionalYer ararken sonuçları yönlendirmek 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ın içindekilerle kısıtlanmaz ancak bu sınırların içindeki sonuçlar daha üst sıralarda yer alır. |
language
isteğe bağlı |
Tür:
string optionalMümkün olduğunda adların ve adreslerin döndürülmesi gereken dil için bir dil tanımlayıcısı. Desteklenen dillerin listesine bakın. |
location
isteğe bağlı |
Tür:
LatLng|LatLngLiteral optionalYer ararken sonuçları etkilemek için kullanılan alanın merkezi. |
query
isteğe bağlı |
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 ayırt edici ("Sidney'de Starbucks"). |
radius
isteğe bağlı |
Tür:
number optionalYer araması yaparken sonuçları yönlendirmek için kullanılan alanın yarıçapı (metre cinsinden). |
region
isteğe bağlı |
Tür:
string optionalSonuçları yönlendirmek için kullanılacak bölge kodu. Bölge kodu, iki karakterli bir ccTLD ("üst düzey alan") değerini kabul eder. Çoğu ccTLD kodu, bazı önemli istisnalar dışında ISO 3166-1 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" ( .co.uk) iken ISO 3166-1 kodu "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" tüzel kişiliği için). |
type
isteğe bağlı |
Tür:
string optionalBelirtilen 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 dizesiyle birleştirilir. Farklı türdeki sonuçlar yanıttan çıkarılır. Dil ve bölgeden bağımsız kategorik aramalar yapmak için bu alanı kullanın. Geçerli türler burada verilmiştir. |
RankBy sabitleri
sabitler
google.maps.places.RankBy
kitaplık "places"
PlaceSearchRequest için sıralama seçenekleri.
const {RankBy} = await google.maps.importLibrary("places");
Sabitler | |
|---|---|
DISTANCE |
Yer sonuçlarını konuma olan mesafeye göre sıralar. |
PROMINENCE |
Yer sonuçlarını önem derecelerine göre sıralar. |
LocationBias typedef
typedef
google.maps.places.LocationBias
LocationBias, yer ararken kullanılacak esnek bir sınırı veya ipucunu temsil eder. Sonuçlar, belirtilen alanın dışından gelebilir. Mevcut kullanıcının IP adresini ağırlık 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
typedef
google.maps.places.LocationRestriction
LocationRestriction, yer ararken kullanılacak kesin bir sınırı temsil eder.
PlacesServiceStatus sabitleri
sabitler
google.maps.places.PlacesServiceStatus
kitaplık "places"
Aramaları tamamlandığında PlacesService tarafından döndürülen durum. Bunları değere göre veya sabitin adını kullanarak belirtin. Örneğin, 'OK' veya google.maps.places.PlacesServiceStatus.OK
Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri PlacesServiceStatusString türüyle tanımlanır.
const {PlacesServiceStatus} = await google.maps.importLibrary("places");
Sabitler | |
|---|---|
INVALID_REQUEST |
Bu istek geçersizdi. |
NOT_FOUND |
Referans verilen yer bulunamadı. |
OK |
Yanıt, geçerli bir sonuç içeriyor. |
OVER_QUERY_LIMIT |
Uygulama, istek kotasını aştı. |
REQUEST_DENIED |
Uygulamanın PlacesService kullanmasına izin verilmiyor. |
UNKNOWN_ERROR |
Sunucu hatası nedeniyle PlacesService isteği işlenemedi. Tekrar denerseniz istek başarılı olabilir. |
ZERO_RESULTS |
Bu istek için sonuç bulunamadı. |
PlaceSearchPagination arayüzü
arayüz
google.maps.places.PlaceSearchPagination
Yer sonuçlarının ek sayfalarını getirmek için kullanılan nesne.
Özellikler | |
|---|---|
hasNextPage |
Tür:
booleanDaha fazla sonuç olup olmadığını gösterir. Ek sonuçlar sayfası olduğunda true. |
Yöntemler | |
|---|---|
nextPage |
nextPage()Parametreler: Yok
Dönüş Değeri:
voidSonraki sonuç sayfasını getirir. İlk arama isteğine sağlanan geri çağırma işlevini kullanır. |
PlaceResult arayüzü
arayüz
google.maps.places.PlaceResult
Bir yerle ilgili bilgileri tanımlar.
Özellikler | |
|---|---|
address_components
isteğe bağlı |
Tür:
Array<GeocoderAddressComponent> optionalBu yerin konumuna ait adres bileşenleri koleksiyonu. Yalnızca PlacesService.getDetails ile kullanılabilir. |
adr_address
isteğe bağlı |
Tür:
string optionalYerin adresinin adr mikro biçimindeki gösterimi. Yalnızca PlacesService.getDetails ile kullanılabilir. |
aspects
isteğe bağlı |
Tür:
Array<Google ve Zagat kullanıcı yorumlarına göre bu yerin puanlanan özellikleri. Puanlar 0 ile 30 arasında değişir. |
business_status
isteğe bağlı |
Tür:
BusinessStatus optionalİşletme ise yerin faaliyet durumunu gösteren bir işaret (yerin faaliyette mi yoksa geçici veya kalıcı olarak kapalı mı olduğunu gösterir). Veri yoksa işaret, arama veya ayrıntı yanıtlarında gösterilmez. |
formatted_address
isteğe bağlı |
Tür:
string optionalYerin tam adresi. |
formatted_phone_number
isteğe bağlı |
Tür:
string optionalYerin telefon numarası, numaranın bölgesel kuralına göre biçimlendirilmiştir. Yalnızca PlacesService.getDetails ile kullanılabilir. |
geometry
isteğe bağlı |
Tür:
PlaceGeometry optionalYerin geometriyle ilgili bilgileri. |
html_attributions
isteğe bağlı |
Tür:
Array<string> optionalBu yer sonucu için gösterilecek atıf metni. Kullanılabilir html_attributions, istenen fields ne olursa olsun her zaman döndürülür ve gösterilmelidir. |
icon
isteğe bağlı |
Tür:
string optionalBu yerin kategorisini temsil etmek için kullanılabilecek bir resim kaynağının URL'si. |
icon_background_color
isteğe bağlı |
Tür:
string optionalBir yerin simgesiyle kullanılacak arka plan rengi. PlaceResult.icon_mask_base_uri başlıklı makaleyi de inceleyin. |
icon_mask_base_uri
isteğe bağlı |
Tür:
string optionalSimge maskesinin kısaltılmış URL'si. Sona bir dosya uzantısı (ör. .svg veya .png) ekleyerek farklı simge türlerine erişebilirsiniz. |
international_phone_number
isteğe bağlı |
Tür:
string optionalYerin uluslararası standarttaki telefon numarası. Uluslararası standart, ülke kodunu içerir ve artı (+) işaretiyle başlar. Yalnızca PlacesService.getDetails ile kullanılabilir. |
name
isteğe bağlı |
Tür:
string optionalYerin adı. Not: Kullanıcı tarafından girilen yerler söz konusu olduğunda bu, kullanıcı tarafından yazılan ham metindir. Kötü amaçlı kullanıcılar bu verileri kod yerleştirme saldırıları için bir vektör olarak kullanmaya çalışabileceğinden, bu verileri kullanırken lütfen dikkatli olun (bkz. http://en.wikipedia.org/wiki/Code_injection). |
opening_hours
isteğe bağlı |
Tür:
PlaceOpeningHours optionalYerin ne zaman açıldığını veya kapandığını tanımlar. |
isteğe bağlı |
Tür:
boolean optionalYerin kalıcı veya geçici olarak kapalı olup olmadığını gösteren işaret. Yer faal durumdaysa veya veri yoksa işaret yanıtta yer almaz. |
photos
isteğe bağlı |
Tür:
Array<PlacePhoto> optionalBu yerin fotoğrafları. Koleksiyonda en fazla on PlacePhoto nesnesi bulunur. |
place_id
isteğe bağlı |
Tür:
string optionalYer için benzersiz bir tanımlayıcı. |
plus_code
isteğe bağlı |
Tür:
PlacePlusCode optionalYer için Açık Konum Kodları'nı veya "plus code'ları" tanımlar. |
price_level
isteğe bağlı |
Tür:
number optionalYerin 0 ile 4 arasında bir ölçekte fiyat seviyesi. Fiyat düzeyleri şu şekilde yorumlanır:
|
rating
isteğe bağlı |
Tür:
number optionalBu yerle ilgili kullanıcı yorumlarına dayalı olarak 1, 0 ile 5, 0 arasında bir puan. |
reviews
isteğe bağlı |
Tür:
Array<PlaceReview> optionalBu yerle ilgili yorumların listesi. Yalnızca PlacesService.getDetails ile kullanılabilir. |
types
isteğe bağlı |
Tür:
Array<string> optional |
url
isteğe bağlı |
Tür:
string optionalBu yerin resmi Google sayfasının URL'si. Bu, Google'a ait olan ve yerle ilgili en iyi bilgileri içeren sayfadır. Yalnızca PlacesService.getDetails ile kullanılabilir. |
user_ratings_total
isteğe bağlı |
Tür:
number optionalBu yerin PlaceResult.rating değerine katkıda bulunan kullanıcı puanlarının sayısı. |
isteğe bağlı |
Tür:
number optionalYerin geçerli saat diliminin UTC'den farkı (dakika cinsinden). Örneğin, Avustralya'nın Sidney şehri yaz saati uygulamasında UTC'den 11 saat ileridedir. Bu nedenle utc_offset, 660 olur. UTC'den önceki saat dilimleri için fark negatiftir. Örneğin, Yeşil Burun Adaları için utc_offset, -60 şeklindedir. Yalnızca PlacesService.getDetails ile kullanılabilir. |
utc_offset_minutes
isteğe bağlı |
Tür:
number optionalYerin geçerli saat diliminin UTC'den farkı (dakika cinsinden). Örneğin, Avustralya'nın Sidney şehri yaz saati uygulamasında UTC'den 11 saat ileridedir. Bu nedenle utc_offset_minutes, 660 olur. UTC'den önceki saat dilimleri için fark negatiftir. Örneğin, Yeşil Burun Adaları için utc_offset_minutes, -60 şeklindedir. Yalnızca PlacesService.getDetails ile kullanılabilir. |
vicinity
isteğe bağlı |
Tür:
string optionalSokak adı, sokak numarası ve yerleşim yeri dahil olmak üzere yerin basitleştirilmiş adresi. İl/eyalet, posta kodu veya ülke bilgileri dahil değildir. Örneğin, Google'ın Sidney, Avustralya ofisinin yakın çevre değeri "48 Pirrama Road, Pyrmont" şeklindedir. Yalnızca PlacesService.getDetails ile kullanılabilir. |
website
isteğe bağlı |
Tür:
string optionalBu yerin yetkili web sitesi (ör. bir işletmenin ana sayfası). Yalnızca PlacesService.getDetails ile kullanılabilir. |
PlaceAspectRating arayüzü
arayüz
google.maps.places.PlaceAspectRating
Kullanıcıların yorum yaptığı yerin bir yönüyle ilgili bilgileri tanımlar.
Özellikler | |
|---|---|
rating |
Tür:
numberBu unsurun puanı. Bağımsız yorumlar için bu, 0 ile 3 arasında bir tam sayıdır. Bir yerin toplu puanları için bu, 0 ile 30 arasında bir tam sayıdır. |
type |
Tür:
stringBakı türü. Örneğin, "food", "decor", "service" veya "overall". |
BusinessStatus sabitleri
sabitler
google.maps.places.BusinessStatus
kitaplık "places"
Yerin işletme durumu. Daha fazla bilgi için web hizmeti belgelerini inceleyin.
Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri BusinessStatusString türüyle tanımlanır.
const {BusinessStatus} = await google.maps.importLibrary("places");
Sabitler | |
|---|---|
CLOSED_PERMANENTLY |
İşletme kalıcı olarak kapalıdır. Daha fazla bilgi için web hizmeti belgelerini inceleyin. |
CLOSED_TEMPORARILY |
İşletme geçici olarak kapalı. Daha fazla bilgi için web hizmeti belgelerini inceleyin. |
FUTURE_OPENING |
İşletme gelecekte açılacak. Daha fazla bilgi için web hizmeti belgelerini inceleyin. |
OPERATIONAL |
İşletme faaldir ancak şu anda açık olmayabilir. Daha fazla bilgi için web hizmeti belgelerini inceleyin. |
PlaceGeometry arayüzü
arayüz
google.maps.places.PlaceGeometry
Bir yerin geometrisiyle ilgili bilgileri tanımlar.
Özellikler | |
|---|---|
location
isteğe bağlı |
Tür:
LatLng optionalYerin konumu. |
viewport
isteğe bağlı |
Tür:
LatLngBounds optionalBu yer haritada gösterilirken tercih edilen görüntü alanı. Yer için tercih edilen görüntü alanı bilinmiyorsa bu özellik null olur. Yalnızca PlacesService.getDetails ile kullanılabilir. |
PlaceOpeningHours arayüzü
arayüz
google.maps.places.PlaceOpeningHours
Bir yerin çalışma saatleri hakkındaki bilgileri tanımlar.
Özellikler | |
|---|---|
isteğe bağlı |
Tür:
boolean optionalYerin şu anda açık olup olmadığı. |
periods
isteğe bağlı |
Tür:
Array<PlaceOpeningHoursPeriod> optionalHaftanın her gününü kapsayan çalışma saatleri, pazar gününden başlayarak kronolojik sırayla gösterilir. Yerin açık olmadığı günler dahil edilmez. Yalnızca PlacesService.getDetails ile kullanılabilir. |
weekday_text
isteğe bağlı |
Tür:
Array<string> optionalHaftanın her günü için biçimlendirilmiş çalışma saatlerini temsil eden yedi dizeden oluşan bir dizi. Places Service, çalışma saatlerini geçerli dile uygun şekilde biçimlendirir ve yerelleştirir. Bu dizideki öğelerin sıralaması dile bağlıdır. Bazı dillerde hafta pazartesi günü başlarken bazılarında pazar günü başlar. Yalnızca PlacesService.getDetails ile kullanılabilir. Diğer çağrılar boş bir dizi döndürebilir. |
Yöntemler | |
|---|---|
isOpen |
isOpen([date])Parametreler:
Dönüş Değeri:
boolean|undefinedYerin şu anda (tarih belirtilmediğinde) veya belirtilen tarihte açık olup olmadığını kontrol edin. Bu yerde PlaceResult.utc_offset_minutes veya PlaceOpeningHours.periods yoksa undefined döndürülür (PlaceOpeningHours.periods yalnızca PlacesService.getDetails üzerinden kullanılabilir). Bu yöntem, tatil saatleri gibi istisnai saatleri dikkate almaz. |
PlaceOpeningHoursPeriod interface
arayüz
google.maps.places.PlaceOpeningHoursPeriod
Bir yerin çalışma saatleri hakkında yapılandırılmış bilgileri tanımlar. Not: Bir yer her zaman açıksa yanıtta close bölümü yer almaz. Müşteriler, her zaman açık olanın 0 değerine sahip day ve "0000" değerine sahip time içeren ve close içermeyen bir open dönemi olarak temsil edilmesine güvenebilir.
Özellikler | |
|---|---|
open |
Yerin açılış saati. |
close
isteğe bağlı |
Tür:
PlaceOpeningHoursTime optionalYerin kapanış saati. |
PlaceOpeningHoursTime arayüzü
arayüz
google.maps.places.PlaceOpeningHoursTime
Bir yerin ne zaman açılıp kapandığını tanımlar.
Özellikler | |
|---|---|
day |
Tür:
numberHaftanın günleri, pazar gününden başlayarak [ 0, 6] aralığında bir sayı olarak gösterilir. Örneğin, 2, salı anlamına gelir. |
hours |
Tür:
numberPlaceOpeningHoursTime.time saatleri, [0, 23] aralığında bir sayı olarak gösterilir. Bu değer, yerin saat diliminde raporlanır. |
minutes |
Tür:
numberPlaceOpeningHoursTime.time değerinin dakika kısmı, [0, 59] aralığında bir sayı olarak gösterilir. Bu değer, yerin saat diliminde bildirilir. |
time |
Tür:
string24 saatlik "ssdd" biçiminde günün saati. Değerler [ "0000", "2359"] aralığındadır. Saat, yerin saat diliminde raporlanır. |
nextDate
isteğe bağlı |
Tür:
number optionalBu PlaceOpeningHoursTime'ın bir sonraki gerçekleşmesini temsil eden zaman damgası ( new Date() ile kullanıma uygun, başlangıçtan itibaren milisaniye cinsinden). Haftanın PlaceOpeningHoursTime.day, PlaceOpeningHoursTime.time ve PlaceResult.utc_offset_minutes değerlerinden hesaplanır. PlaceResult.utc_offset_minutes undefined ise nextDate undefined olur. |
PlacePlusCode arayüzü
arayüz
google.maps.places.PlacePlusCode
Bir yer için Açık Konum Kodları'nı veya "Plus Code'ları" tanımlar. Plus Code'lar, açık adreslerin bulunmadığı yerlerde (binaların numaralandırılmadığı veya sokakların adlandırılmadığı yerler) açık adreslerin yerine kullanılabilir.
Özellikler | |
|---|---|
global_code |
Tür:
string1/8.000 dereceye 1/8.000 derece alanlı bir Plus Code. Örneğin, "8FVC9G8F+5W". |
compound_code
isteğe bağlı |
Tür:
string optionalİlk dört karakterin (alan kodu) çıkarılıp yerine bir konum açıklamasının getirildiği, 1/8000 dereceye 1/8000 derece alana sahip bir Plus Code. Örneğin, "9G8F+5W Zurich, Switzerland". Kodu kısaltmak için uygun bir yerleşim yeri bulunamazsa bu alan atlanır. |
PlacePhoto arayüzü
arayüz
google.maps.places.PlacePhoto
Bir yerin fotoğraf öğesini temsil eder.
Özellikler | |
|---|---|
height |
Tür:
numberFotoğrafın piksel cinsinden yüksekliği. |
html_attributions |
Tür:
Array<string>Bu fotoğraf için gösterilecek atıf metni. |
width |
Tür:
numberFotoğrafın piksel cinsinden genişliği. |
Yöntemler | |
|---|---|
getUrl |
getUrl([opts])Parametreler:
Dönüş Değeri:
stringBelirtilen seçeneklere karşılık gelen resim URL'sini döndürür. |
PhotoOptions arayüzü
arayüz
google.maps.places.PhotoOptions
Fotoğraf isteme seçeneklerini tanımlar.
Özellikler | |
|---|---|
maxHeight
isteğe bağlı |
Tür:
number optionalDöndürülen resmin piksel cinsinden maksimum yüksekliği. |
maxWidth
isteğe bağlı |
Tür:
number optionalDöndürülen resmin piksel cinsinden maksimum genişliği. |
PlaceReview arayüzü
arayüz
google.maps.places.PlaceReview
Bir yerle ilgili tek bir yorumu temsil eder.
Özellikler | |
|---|---|
author_name |
Tür:
stringYorumcunun adı. |
language |
Tür:
stringBu yorumun yazıldığı dili belirten bir IETF dil kodu. Bu kodun, ülke veya bölgeyi belirten ikincil bir etiket olmadan yalnızca ana dil etiketini içerdiğini unutmayın. Örneğin, tüm İngilizce yorumlar "en-AU" veya "en-UK" yerine 'en' olarak etiketlenir. |
profile_photo_url |
Tür:
stringYorumu yapan kullanıcının profil resminin URL'si. |
relative_time_description |
Tür:
stringYorumun yapıldığı zamanı, dile ve ülkeye uygun bir biçimde geçerli zamana göre ifade eden, biçimlendirilmiş bir dize. Örneğin, "a month ago". |
text |
Tür:
stringYorumun metni. |
time |
Tür:
numberYorumun zaman damgası, epoch'tan itibaren saniye cinsinden ifade edilir. |
isteğe bağlı |
Tür:
Array<Yorumda değerlendirilen özellikler. 0 ile 3 arasında puanlar. |
author_url
isteğe bağlı |
Tür:
string optionalYorumcunun profilinin URL'si. Yorumcunun profili kullanılamıyorsa bu değer undefined olur. |
rating
isteğe bağlı |
Tür:
number optionalBu yorumun puanı, 1,0 ile 5,0 (bu değerler dahil) arasında bir sayıdır. |