REST Resource: places

Kaynak: Yer

Bir Yeri temsil eden tüm bilgiler.

JSON gösterimi
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  }
}
Alanlar
name

string

Bu yerin places/{placeId} biçimindeki kaynak adı. Yeri aramak için kullanılabilir.

id

string

Bir yerin benzersiz tanımlayıcısıdır.

displayName

object (LocalizedText)

Yerin, kullanıcıların okuyabileceği kısa bir açıklamaya uygun olan yerelleştirilmiş adı. Örneğin, "Google İstanbul", "Starbucks", "İzmir" vb.

types[]

string

Bu sonuç için bir tür etiketi grubu. Örneğin, "siyasi" ve "yerellik". Olası değerlerin tam listesi için https://developers.google.com/maps/documentation/places/web-service/place-types adresindeki Tablo A ve Tablo B'ye bakın.

primaryType

string

Belirli bir sonucun birincil türü. Bu tür, Places API'nin desteklediği türlerden biri olmalıdır. Örneğin, "restoran", "kafe", "havaalanı" vb. Bir yerin yalnızca tek bir birincil türü olabilir. Olası değerlerin tam listesi için https://developers.google.com/maps/documentation/places/web-service/place-types adresindeki Tablo A ve Tablo B'ye bakın.

primaryTypeDisplayName

object (LocalizedText)

Birincil türün görünen adı (varsa istek dili için yerelleştirilmiş). Olası değerlerin tam listesi için https://developers.google.com/maps/documentation/places/web-service/place-types adresindeki Tablo A ve Tablo B'ye bakın.

nationalPhoneNumber

string

Söz konusu yerin, ulusal biçimde, kullanıcıların okuyabileceği bir telefon numarası.

internationalPhoneNumber

string

Yerin kullanıcılar tarafından okunabilen, uluslararası standarda uygun telefon numarası.

formattedAddress

string

Bu yerin tam, kullanıcılar tarafından okunabilen adresi.

shortFormattedAddress

string

Bu yerin kullanıcılar tarafından okunabilen kısa adresi.

addressComponents[]

object (AddressComponent)

Her yerellik düzeyi için tekrarlanan bileşenler. addressComponents[] dizisiyle ilgili aşağıdaki gerçeklere dikkat edin: - Adres bileşenleri dizisi, formattedAddress'den daha fazla bileşen içerebilir. - Dizi, formattedAddress içinde bulunanlar dışında, bir adres içeren tüm siyasi varlıkları içermemelidir. Belirli bir adres içeren tüm siyasi varlıkları almak için geriye coğrafi kodlama kullanmanız ve adresin enlem/boylam değerlerini isteğe parametre olarak iletmeniz gerekir. - Yanıt biçiminin istekler arasında aynı kalacağı garanti edilmez. Özellikle, addressComponents'ın sayısı istenen adrese göre değişir ve aynı adres için zaman içinde değişebilir. Bir bileşen, dizideki konumunu değiştirebilir. Bileşenin türü değişebilir. Daha sonra verilecek bir yanıtta belirli bir bileşen eksik olabilir.

plusCode

object (PlusCode)

Yer konumunun enlem/boylam artı kodu.

location

object (LatLng)

Bu yerin konumu.

viewport

object (Viewport)

Yeri ortalama boyutlu bir harita üzerinde göstermeye uygun bir görüntü alanı.

rating

number

Bu yerin kullanıcı yorumlarına göre 1,0 ile 5,0 arasında bir puan.

googleMapsUri

string

Bu yer hakkında daha fazla bilgi sağlayan bir URL.

websiteUri

string

Bu yerin yetkili web sitesi, ör. bir işletme ana sayfa. Bir zincirin parçası olan yerler (ör. IKEA mağazası) için bunun genellikle zincirin geneli değil, bağımsız mağazanın web sitesi olduğunu unutmayın.

reviews[]

object (Review)

Bu yer hakkındaki yorumların, alaka düzeyine göre sıralanmış listesi. En fazla 5 yorum döndürülebilir.

regularOpeningHours

object (OpeningHours)

Normal çalışma saatleri.

photos[]

object (Photo)

Bu yerin fotoğraflarıyla ilgili bilgiler (referanslar dahil). En fazla 10 fotoğraf döndürülebilir.

adrFormatAddress

string

Yerin adr mikro biçimindeki adresi: http://microformats.org/wiki/adr.

businessStatus

enum (BusinessStatus)

Yerin işletme durumu.

priceLevel

enum (PriceLevel)

Yerin fiyat düzeyi.

attributions[]

object (Attribution)

Bu sonuçla birlikte gösterilmesi gereken bir veri sağlayıcı grubu.

iconMaskBaseUri

string

Simge maskesinin kısaltılmış URL'si. Kullanıcı, sonuna tür son eki ekleyerek farklı simge türlerine erişebilir (ör. ".svg" veya ".png").

iconBackgroundColor

string

icon_mask için onaltılık biçimdeki arka plan rengi, ör. #909CE1.

currentOpeningHours

object (OpeningHours)

Önümüzdeki yedi gün içindeki çalışma saatleri (bugün dahil). Süre, istek tarihinde gece yarısı başlar ve altı gün sonra saat 23:59'da sona erer. Bu alan, tüm saatlerin özel günleri alt alanını içerir ve istisnai saatlere sahip tarihler için ayarlanır.

currentSecondaryOpeningHours[]

object (OpeningHours)

İşletmenin ikincil çalışma saatleriyle ilgili bilgileri de içeren, sonraki yedi güne ilişkin bir dizi giriş içerir. İkincil çalışma saatleri, işletmenin ana çalışma saatlerinden farklıdır. Örneğin, bir restoran ikinci çalışma saatleri olarak arabaya servisle çalışma saatlerini veya teslimat saatlerini belirtebilir. Bu alan, yer türüne göre önceden tanımlanmış bir çalışma saati türü listesinden (DRIVE_THROUGH, PICKUP veya TAKEOUT gibi) alınan tür alt alanını doldurur. Bu alan, tüm saatlerin özel günleri alt alanını içerir ve istisnai saatlere sahip tarihler için ayarlanır.

regularSecondaryOpeningHours[]

object (OpeningHours)

İşletmenin normal ikincil çalışma saatleri hakkında bilgi veren bir dizi giriş içerir. İkincil çalışma saatleri, işletmenin ana çalışma saatlerinden farklıdır. Örneğin, bir restoran ikinci çalışma saatleri olarak arabaya servisle çalışma saatlerini veya teslimat saatlerini belirtebilir. Bu alan, yer türüne göre önceden tanımlanmış bir çalışma saati türü listesinden (DRIVE_THROUGH, PICKUP veya TAKEOUT gibi) alınan tür alt alanını doldurur.

editorialSummary

object (LocalizedText)

Yerin özetini içerir. Özet, metin şeklinde bir genel bakıştan oluşur ve varsa bu özetlerin dil kodunu da içerir. Özet metin olduğu gibi sunulmalıdır ve değiştirilemez ya da değiştirilemez.

paymentOptions

object (PaymentOptions)

Mağazanın kabul ettiği ödeme seçenekleri. Ödeme seçeneği verisi mevcut değilse ödeme seçeneği alanı ayarlanmamıştır.

parkingOptions

object (ParkingOptions)

Yerin sunduğu otopark seçenekleri.

subDestinations[]

object (SubDestination)

Yerle ilgili alt hedeflerin listesi.

fuelOptions

object (FuelOptions)

Bir benzin istasyonundaki yakıt seçenekleriyle ilgili en güncel bilgiler. Bu bilgiler düzenli olarak güncellenir.

evChargeOptions

object (EVChargeOptions)

Ev şarj seçenekleri hakkında bilgi.

generativeSummary

object (GenerativeSummary)

Deneysel: Daha fazla ayrıntı için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative sayfasına göz atın.

Yapay zeka tarafından üretilmiş yer özeti.

areaSummary

object (AreaSummary)

Deneysel: Daha fazla ayrıntı için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative sayfasına göz atın.

Mekanın bulunduğu bölgenin yapay zeka tarafından üretilmiş özeti.

utcOffsetMinutes

integer

Bu yerin saat diliminin şu anda UTC ile farkı olan dakika sayısı. Bu değer, bir saatin kesirleriyle uzaklık verilen saat dilimlerini desteklemek için dakika cinsinden ifade edilir (ör. X saat 15 dakika.

userRatingCount

integer

Bu yer için toplam yorum sayısı (metin içeren veya içermeyen).

takeout

boolean

İşletmenin paket servisi özelliğini destekleyip desteklemediğini belirtir.

delivery

boolean

İşletmenin, teslimatı destekleyip desteklemediğini belirtir.

dineIn

boolean

İşletmenin iç veya dış oturma seçeneklerini destekleyip desteklemediğini belirtir.

curbsidePickup

boolean

İşletmenin arabaya teslim almayı destekleyip desteklemediğini belirtir.

reservable

boolean

Yerin rezervasyonları destekleyip desteklemediğini belirtir.

servesBreakfast

boolean

Kahvaltı servisi olup olmadığını belirtir.

servesLunch

boolean

Burada öğle yemeği servisi olup olmadığını belirtir.

servesDinner

boolean

Burada akşam yemeği servisi olup olmadığını belirtir.

servesBeer

boolean

Yerin bira servisi yapıp yapmadığını belirtir.

servesWine

boolean

Burada şarap servisi olup olmadığını belirtir.

servesBrunch

boolean

Yerin brunch servisi yapıp yapmadığını belirtir.

servesVegetarianFood

boolean

Yerin vejetaryen yemek servisi yapıp yapmadığını belirtir.

outdoorSeating

boolean

Açık havada oturma alanı vardır.

liveMusic

boolean

Mekan, canlı müzik performanslarına sahne oluyor.

menuForChildren

boolean

Yerde çocuk menüsü vardır.

servesCocktails

boolean

Bu yerde kokteyl servisi vardır.

servesDessert

boolean

Burada tatlı servisi var.

servesCoffee

boolean

Bu yerde kahve servisi var.

goodForChildren

boolean

Yer çocuklar için uygun.

allowsDogs

boolean

Yer köpeklere izin verir.

restroom

boolean

Bu yerde tuvalet var.

goodForGroups

boolean

Yer, grupları barındırabilir.

goodForWatchingSports

boolean

Burası, spor etkinliklerini izlemek için uygun.

accessibilityOptions

object (AccessibilityOptions)

Bir yerin sunduğu erişilebilirlik seçenekleri hakkında bilgi.

LocalizedText

Bir metnin belirli bir dildeki yerelleştirilmiş varyantı.

JSON gösterimi
{
  "text": string,
  "languageCode": string
}
Alanlar
text

string

Aşağıdaki languageCode öğesine karşılık gelen dilde yerelleştirilmiş dize.

languageCode

string

Metnin BCP-47 dil kodu (ör. "en-US") veya "sr-Latn" girin.

Daha fazla bilgi için http://www.unicode.org/reports/tr35/#Unicode_locale_identifier sayfasına bakın.

AddressComponent

Bu bilgiler varsa biçimlendirilmiş adresi oluşturan yapılandırılmış bileşenler.

JSON gösterimi
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
Alanlar
longText

string

Adres bileşeninin tam metin açıklaması veya adı. Örneğin, Avustralya ülkesinin adres bileşeninde "Avustralya" uzun_adı olabilir.

shortText

string

Varsa adres bileşeninin kısaltılmış metin adı. Örneğin, Avustralya ülkesine ait bir adres bileşeninde "AU" şeklinde bir kısa_ad bulunabilir.

types[]

string

Adres bileşeninin türlerini gösteren dizi.

languageCode

string

Bu bileşenleri biçimlendirmek için CLDR gösteriminde kullanılan dil.

PlusCode

Artı kodu (http://plus.codes), iki biçime sahip bir konum referansıdır: 14mx14 m (derecenin 1/8000'i) veya daha küçük bir dikdörtgen tanımlayan genel kod ve ön eki bir referans konumuyla değiştiren bileşik kod.

JSON gösterimi
{
  "globalCode": string,
  "compoundCode": string
}
Alanlar
globalCode

string

Yerin 1/8.000 x 1/8.000 derecelik bir alanı (~14 x 14 metre) temsil eden "9FWM33GV+HQ" gibi global (tam) kodu.

compoundCode

string

Yerin "33GV+HQ, Ramberg, Norveç" gibi bir bileşik kodudur. Global kodun son ekini içeren ve öneki, bir referans varlığına ait biçimlendirilmiş adla değiştirir.

LatLng

Enlem/boylam çiftini temsil eden bir nesne. Bu, enlem ve boylam derecelerini temsil eden bir çift çift olarak ifade edilir. Aksi belirtilmedikçe bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklar içinde olmalıdır.

JSON gösterimi
{
  "latitude": number,
  "longitude": number
}
Alanlar
latitude

number

Derece cinsinden enlem. [-90,0, +90,0] aralığında olmalıdır.

longitude

number

Derece cinsinden boylam. [-180.0, +180.0] aralığında olmalıdır.

Görüntü alanı

low ve high noktasının çapraz olarak iki yönünde çapraz olarak gösterilen enlem-boylam görüntü alanı. Görüntü alanı, kapalı bir bölge olarak kabul edilir. Yani kendi sınırlarını içerir. Enlem sınırları -90 ile 90 derece (dahil) arasında, boylam sınırları ise -180 ile 180 derece (her ikisi de dahil) arasında olmalıdır. Çeşitli durumlar şunlardır:

  • low = high olursa, görüntü alanı bu tek noktadan oluşur.

  • Eğer low.longitude > high.longitude ise, boylam aralığı tersine çevrilir (görüntü alanı 180 derecelik boylam çizgisini geçer).

  • low.longitude = -180 derece ve high.longitude = 180 derece ise görüntü alanı tüm boylamları içerir.

  • low.longitude = 180 derece ve high.longitude = -180 derece ise boylam aralığı boş olur.

  • Eğer low.latitude > high.latitude, enlem aralığı boş.

Hem low hem de high doldurulmalı ve gösterilen kutu (yukarıdaki tanımlarda belirtildiği gibi) boş bırakılamaz. Boş görüntü alanı hatayla sonuçlanır.

Örneğin, bu görüntü alanı New York City'yi tamamen kapsar:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON gösterimi
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Alanlar
low

object (LatLng)

Zorunlu. Görüntü alanının düşük noktası.

high

object (LatLng)

Zorunlu. Görüntü alanının yüksek noktası.

İncele

Bir yerle ilgili yorumlar hakkında bilgiler.

JSON gösterimi
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string
}
Alanlar
name

string

Bu yer yorumunu temsil eden ve bu yer yorumunu tekrar aramak için kullanılabilecek bir referans (API "kaynak" adı: places/{placeId}/reviews/{review} olarak da adlandırılır).

relativePublishTimeDescription

string

Dil ve ülkeye uygun bir biçimde geçerli zamana göre inceleme zamanını ifade eden, biçimlendirilmiş son saat dizesi.

text

object (LocalizedText)

Yorumun yerelleştirilmiş metni.

originalText

object (LocalizedText)

Orijinal dilinde yorum metni.

rating

number

1,0 ile 5,0 arasında bir sayıdır. Yıldız sayısı da denir.

authorAttribution

object (AuthorAttribution)

Bu yorumun yazarı.

publishTime

string (Timestamp format)

İncelemenin zaman damgası.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

AuthorAttribution

Kullanıcı tarafından oluşturulan içerik verilerinin yazarı hakkında bilgi. Photo ve Review ülkelerde kullanılıyor.

JSON gösterimi
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
Alanlar
displayName

string

Photo veya Review yazarının adı.

uri

string

Photo veya Review yazarının URI'sı.

photoUri

string

Photo veya Review yazarının profil fotoğrafı URI'si.

OpeningHours

Yerin çalışma saatleri hakkında bilgiler.

JSON gösterimi
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "openNow": boolean
}
Alanlar
periods[]

object (Period)

Bu yerin hafta boyunca açık olduğu dönemler. Dönemler, yerel saat diliminde Pazar gününden başlayarak kronolojik sıradadır. Boş (ancak mevcut olmayan) bir değer hiçbir zaman açık olmayan bir yeri belirtir, ör. çünkü tadilat için geçici olarak kapalı.

weekdayDescriptions[]

string

Haftanın her günü için bir dize olmak üzere, bu yerin çalışma saatlerini açıklayan yerelleştirilmiş dizeler. Çalışma saatleri bilinmiyorsa veya yerelleştirilmiş metne dönüştürülemiyorsa boş olur. Örnek: "Paz: 18:00–06:00"

secondaryHoursType

enum (SecondaryHoursType)

İkincil çalışma saatlerinin türünü tanımlamak için kullanılan bir tür dizesi.

specialDays[]

object (SpecialDay)

Döndürülen çalışma saatlerinin kapsadığı döneme denk gelen özel günler için yapılandırılmış bilgiler. Özel günler, bir yerin çalışma saatlerini etkileyebilecek günlerdir. Örneğin, Noel günü. İstisnai saatler varsa currentOpeningHours ve currentsecondaryOpeningHours için ayarlayın.

openNow

boolean

Burası şu anda açık mı? Bu çalışma saatleri için saat veya saat dilimi verileri eksik olmadığı sürece her zaman mevcuttur.

Dönem

Yerin openNow durumunda kaldığı bir nokta.

JSON gösterimi
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
Alanlar
open

object (Point)

Yerin açılmaya başladığı saat.

close

object (Point)

Yerin kapanmaya başladığı saat.

Nokta

Durumda değişen noktalar.

JSON gösterimi
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
Alanlar
date

object (Date)

Yerin yerel saat dilimindeki tarih.

truncated

boolean

Bu uç noktanın kesilip kesilmediği. Kesilme, gerçek çalışma saatleri arasında geri dönmek istediğimiz saatlerin dışında olduğunda gerçekleşir. Bu nedenle saatleri tekrar bu sınırlara indiririz. Bu, istek günü gece yarısından itibaren en fazla 24 * 7 saatin döndürülmesini sağlar.

day

integer

0-6 aralığında bir tam sayı olarak haftanın bir günü. 0 Pazar, 1 Pazartesi vb.

hour

integer

2 haneli saat. 00 ile 23 arasında değişir.

minute

integer

2 basamaklı dakika. 00 ile 59 arasında değişir.

Tarih

Takvimin tamamını veya bir kısmını temsil eder (ör. doğum günü). Günün saati ve saat dilimi başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim'e göredir. Bu, aşağıdakilerden birini temsil edebilir:

  • Sıfır olmayan yıl, ay ve gün değerleriyle tam tarih.
  • Bir ay ve gün ile sıfır yıl (örneğin, bir yıl dönümü).
  • Tek başına bir yıl, sıfır ay ve sıfır gün.
  • Sıfır gün içeren bir yıl ve ay (örneğin, kredi kartı son kullanma tarihi).

İlgili türler:

JSON gösterimi
{
  "year": integer,
  "month": integer,
  "day": integer
}
Alanlar
year

integer

Tarihin yılı. 1 ile 9999 arasında veya yıl içermeyen bir tarihi belirtmek için 0 arasında olmalıdır.

month

integer

Bir yılın ayı. 1 ile 12 arasında veya ay ve gün içermeyen bir yılı belirtmek için 0 arasında olmalıdır.

day

integer

Ayın günü. 1 ile 31 arasında bir değer olmalı ve yıl ve ay için geçerlidir. Yalnızca yılı belirtmek için 0 değerini veya günün önemli olmadığı bir yılı ve ayı belirtmek için 0 değerini girin.

SecondaryHoursType

İkincil çalışma saatlerinin türünü tanımlamak için kullanılan bir tür.

Sıralamalar
SECONDARY_HOURS_TYPE_UNSPECIFIED İkincil saat türü belirtilmediğinde varsayılan değer.
DRIVE_THROUGH Bankalar, restoranlar veya eczaneler için arabaya servis saatleri.
HAPPY_HOUR İndirimli saatler.
DELIVERY Teslimat saati.
TAKEOUT Paket servisi saati.
KITCHEN Mutfak saati.
BREAKFAST Kahvaltı saati.
LUNCH Öğle yemeği saati.
DINNER Akşam yemeği saati.
BRUNCH Geç kahvaltı saati.
PICKUP Teslim alma saati.
ACCESS Depolama yerleri için erişim saatleri.
SENIOR_HOURS Yaşlılar için özel çalışma saatleri.
ONLINE_SERVICE_HOURS Online hizmet saatleri.

SpecialDay

Döndürülen çalışma saatlerinin kapsadığı döneme denk gelen özel günler için yapılandırılmış bilgiler. Özel günler, bir yerin çalışma saatlerini etkileyebilecek günlerdir. Örneğin, Noel günü.

JSON gösterimi
{
  "date": {
    object (Date)
  }
}
Alanlar
date

object (Date)

Bu özel günün tarihi.

Fotoğraf

Bir yerin fotoğrafı hakkında bilgiler.

JSON gösterimi
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ]
}
Alanlar
name

string

Tanımlayıcı. Bu yerin fotoğrafını tekrar aramak için kullanılabilecek ve bu yerin fotoğrafını temsil eden bir referans (API "kaynak" adı olarak da adlandırılır: places/{placeId}/photos/{photo}).

widthPx

integer

Piksel cinsinden kullanılabilir maksimum genişlik.

heightPx

integer

Piksel cinsinden kullanılabilir maksimum yükseklik.

authorAttributions[]

object (AuthorAttribution)

Bu fotoğrafın yazarları.

BusinessStatus

Yerin işletme durumu.

Sıralamalar
BUSINESS_STATUS_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
OPERATIONAL Tesis çalışır durumda, şu anda açık olmayabilir.
CLOSED_TEMPORARILY Tesis geçici olarak kapalı.
CLOSED_PERMANENTLY Tesis kalıcı olarak kapatıldı.

PriceLevel

Yerin fiyat düzeyi.

Sıralamalar
PRICE_LEVEL_UNSPECIFIED Yerin fiyat düzeyi belirtilmemiş veya bilinmiyor.
PRICE_LEVEL_FREE Burası ücretsiz hizmetler sunar.
PRICE_LEVEL_INEXPENSIVE Yer, pahalı olmayan hizmetler sunuyor.
PRICE_LEVEL_MODERATE Yer, orta fiyatlı hizmetler sunmaktadır.
PRICE_LEVEL_EXPENSIVE Burası pahalı hizmetler sunuyor.
PRICE_LEVEL_VERY_EXPENSIVE Burası çok pahalı hizmetler sunuyor.

İlişkilendirme

Bu yerin veri sağlayıcıları hakkında bilgiler.

JSON gösterimi
{
  "provider": string,
  "providerUri": string
}
Alanlar
provider

string

Yerin veri sağlayıcısının adı.

providerUri

string

Yerin veri sağlayıcısına giden URI.

PaymentOptions

Mağazanın kabul ettiği ödeme seçenekleri.

JSON gösterimi
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
Alanlar
acceptsCreditCards

boolean

Yer, ödeme olarak kredi kartlarını kabul ediyor.

acceptsDebitCards

boolean

Yer, ödeme olarak banka kartlarını kabul ediyor.

acceptsCashOnly

boolean

Yer, ödeme olarak yalnızca nakit ödeme kabul eder. Bu özelliğe sahip yerler, diğer ödeme yöntemlerini kabul etmeye devam edebilir.

acceptsNfc

boolean

Yer, NFC ödemelerini kabul ediyor.

ParkingOptions

Yer için park seçenekleri hakkında bilgi. Bir otopark aynı anda birden fazla seçeneği destekleyebilir.

JSON gösterimi
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
Alanlar
freeParkingLot

boolean

Ücretsiz otopark mevcuttur.

paidParkingLot

boolean

Tesiste ücretli otoparklar mevcuttur.

freeStreetParking

boolean

Otelin cadde üzerinde ücretsiz otopark hizmeti vardır.

paidStreetParking

boolean

Otelin cadde üzerinde ücretli otoparkı vardır.

valetParking

boolean

Otelde vale park hizmeti vardır.

freeGarageParking

boolean

Otelde ücretsiz kapalı otopark mevcuttur.

paidGarageParking

boolean

Otelde ücretli kapalı otopark mevcuttur.

SubDestination

Yerle ilgili alt hedeflerin kaynak adını ve kimliğini girin. Örneğin, farklı terminaller bir havaalanının farklı varış noktalarıdır.

JSON gösterimi
{
  "name": string,
  "id": string
}
Alanlar
name

string

Alt hedefin kaynak adı.

id

string

Alt hedefin yer kimliği.

AccessibilityOptions

Bir yerin sunduğu erişilebilirlik seçenekleri hakkında bilgi.

JSON gösterimi
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
Alanlar
wheelchairAccessibleParking

boolean

Tesiste tekerlekli sandalyeye uygun otopark mevcuttur.

wheelchairAccessibleEntrance

boolean

Yerlerin tekerlekli sandalyeye uygun girişi vardır.

wheelchairAccessibleRestroom

boolean

Yerde tekerlekli sandalyeye uygun tuvalet var.

wheelchairAccessibleSeating

boolean

Yerde tekerlekli sandalyeye uygun oturma düzeni var.

FuelOptions

Bir benzin istasyonundaki yakıt seçenekleriyle ilgili en güncel bilgiler. Bu bilgiler düzenli olarak güncellenir.

JSON gösterimi
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
Alanlar
fuelPrices[]

object (FuelPrice)

Bu istasyonun her yakıt türü için bilinen son yakıt fiyatı. Bu istasyondaki her yakıt türü için bir giriş var. Sıra önemli değildir.

FuelPrice

Belirli bir tür için yakıt fiyatı bilgileri.

JSON gösterimi
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
Alanlar
type

enum (FuelType)

Yakıt türü.

price

object (Money)

Yakıtın fiyatı.

updateTime

string (Timestamp format)

Yakıt fiyatının son güncellendiği zaman.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

FuelType

Yakıt türleri.

Sıralamalar
FUEL_TYPE_UNSPECIFIED Yakıt türü belirtilmedi.
DIESEL Dizel yakıt.
REGULAR_UNLEADED Normal, kurşunsuz.
MIDGRADE 89 Oktan.
PREMIUM Premium.
SP91 SP 91.
SP91_E10 SP 91 E10
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10
SP98 SP 98.
SP99 SP 99.
SP100 SP 100
LPG LPG'ye dokunun.
E80 E 80.
E85 E 85.
METHANE Metan.
BIO_DIESEL Biyodizel.
TRUCK_DIESEL Kamyon dizel.

Para

Para birimi türüyle birlikte bir para tutarını gösterir.

JSON gösterimi
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Alanlar
currencyCode

string

ISO 4217'de tanımlanan üç harfli para birimi kodu.

units

string (int64 format)

Tutarın tam birimi. Örneğin, currencyCode "USD" ise 1 birim bir ABD dolarıdır.

nanos

integer

Tutarın nano (10^-9) birimlerinin sayısı. Değer -999.999.999 ile +999.999.999 (bu değerler dahil) arasında olmalıdır. units pozitifse nanos pozitif veya sıfır olmalıdır. units sıfırsa nanos pozitif, sıfır veya negatif olabilir. units negatifse nanos negatif veya sıfır olmalıdır. Örneğin $-1,75 şu şekilde ifade edilir: units=-1 ve nanos=-750.000.000.

EVChargeOptions

Yerinde barındırılan elektrikli araç şarj istasyonu hakkında bilgi. Terminoloji şu şekildedir: https://afdc.energy.gov/fuels/electricity_infrastructure.html Bir bağlantı noktasında aynı anda bir araba şarj edilebilir. Bir bağlantı noktasında bir veya daha fazla bağlayıcı var. Bir istasyonda bir veya daha fazla bağlantı noktası var.

JSON gösterimi
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
Alanlar
connectorCount

integer

Bu istasyondaki konnektör sayısı. Bununla birlikte, bazı bağlantı noktalarında birden fazla konnektör olabileceği, ancak aynı anda yalnızca bir aracı şarj edebildiği (ör.) konnektörlerin sayısı, aynı anda şarj edilebilen toplam araba sayısından daha fazla olabilir.

connectorAggregation[]

object (ConnectorAggregation)

Aynı türde ve aynı şarj hızında konnektörler içeren elektrikli araç şarj bağlayıcısı toplamlarının listesi.

ConnectorAggregation

Elektrikli araç şarj bilgileri [tür, maxChargeRateKw] türüne göre gruplandırılmıştır. Aynı türe ve maksimum şarj hızına sahip olan bağlayıcıların EV şarjı toplamını gösterir.

JSON gösterimi
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
Alanlar
type

enum (EVConnectorType)

Bu toplamanın bağlayıcı türü.

maxChargeRateKw

number

Toplamadaki her bağlayıcının kw cinsinden statik maks. şarj hızı.

count

integer

Bu toplamadaki bağlayıcı sayısı.

availabilityLastUpdateTime

string (Timestamp format)

Bu toplamadaki bağlayıcı kullanılabilirlik bilgilerinin en son güncellendiği zaman damgası.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

availableCount

integer

Bu toplamada şu anda kullanılabilen bağlayıcı sayısı.

outOfServiceCount

integer

Bu toplamadaki şu anda hizmet dışı olan bağlayıcı sayısı.

EVConnectorType

Elektrikli araç şarj konnektörü türleriyle ilgili ek bilgi/bağlam için http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 adresine bakın.

Sıralamalar
EV_CONNECTOR_TYPE_UNSPECIFIED Bağlayıcı belirtilmemiş.
EV_CONNECTOR_TYPE_OTHER Diğer bağlayıcı türleri.
EV_CONNECTOR_TYPE_J1772 J1772 tür 1 bağlayıcı.
EV_CONNECTOR_TYPE_TYPE_2 IEC 62196 tür 2 konnektörü. Bunlar genellikle ERKEKLER olarak adlandırılır.
EV_CONNECTOR_TYPE_CHADEMO CHAdeMO türü bağlayıcı.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Birleşik Şarj Sistemi (AC ve DC). SAE'ye göredir. Type-1 J-1772 konnektörü
EV_CONNECTOR_TYPE_CCS_COMBO_2 Birleşik Şarj Sistemi (AC ve DC). Tür-2 Mennekes bağlayıcısına göre
EV_CONNECTOR_TYPE_TESLA Genel TESLA bağlayıcısı. Bu, Kuzey Amerika'da NACS'dir, ancak dünyanın diğer bölgelerinde NACS dışında da olabilir (ör. CCS Combo 2 (CCS2) veya GB/T). Bu değer, gerçek bir konnektör türünü daha az temsil eder; daha fazlası, Tesla'ya ait şarj istasyonunda Tesla markalı bir aracı şarj etme imkanını temsil eder.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T GB/T türü, Çin'deki GB/T standardına karşılık gelir. Bu tür tüm GB_T türlerini kapsar.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Duvar prizi belirtilmemiş.

GenerativeSummary

Deneysel: Daha fazla ayrıntı için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative sayfasına göz atın.

Yapay zeka tarafından üretilmiş yer özeti.

JSON gösterimi
{
  "overview": {
    object (LocalizedText)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Alanlar
overview

object (LocalizedText)

Yere genel bakış.

description

object (LocalizedText)

Yerin ayrıntılı açıklaması.

references

object (References)

Özet açıklamasını oluşturmak için kullanılan referanslar.

Referanslar

Deneysel: Daha fazla ayrıntı için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative sayfasına göz atın.

Üretken içeriğin ilgili olduğu referanslar

JSON gösterimi
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
Alanlar
reviews[]

object (Review)

Referans işlevi gören yorumlar.

places[]

string

Referans verilen yerlerin kaynak adlarının listesi. Bu ad, Yer kaynağı adlarını kabul eden diğer API'lerde kullanılabilir.

AreaSummary

Deneysel: Daha fazla ayrıntı için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative sayfasına göz atın.

Mekanın bulunduğu bölgenin yapay zeka tarafından üretilmiş özeti.

JSON gösterimi
{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ]
}
Alanlar
contentBlocks[]

object (ContentBlock)

Alan özetini oluşturan içerik blokları. Her blokta bölgeyle ilgili ayrı bir konu vardır.

ContentBlock

Ayrı olarak sunulabilen bir içerik bloğu.

JSON gösterimi
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Alanlar
topic

string

İçeriğin konusu (ör. "genel bakış") veya "restoran" gibi adlar da kullanabilirsiniz.

content

object (LocalizedText)

Konuyla ilgili içerik.

references

object (References)

Deneysel: Daha fazla ayrıntı için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative sayfasına göz atın.

Bu içerik bloğuyla ilgili referanslar.

Yöntemler

autocomplete

Verilen girişle ilgili tahminleri döndürür.

get

Bir yerin ayrıntılarını, places/{place_id} biçiminde bir dize olan kaynak adına göre öğrenin.

searchNearby

Konumların yakınındaki yerleri arayın.

searchText

Metin sorgusuna dayalı yer arama.