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)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "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)
  },
  "pureServiceAreaBusiness": boolean
}
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ı.

displayName

object (LocalizedText)

Yerin yerelleştirilmiş adı. Kullanıcıların okuyabileceği kısa bir açıklama olarak uygundur. Örneğin, "Google Sydney", "Starbucks", "Pyrmont" vb.

types[]

string

Bu sonuç için bir tür etiket grubu. Örneğin, "political" ve "locality". 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 tarafından desteklenen 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 diline 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

Yerin, ulusal biçimdeki okunabilir 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 kısa ve okunabilir adresi.

addressComponents[]

object (AddressComponent)

Her yerellik düzeyi için tekrarlanan bileşenler. addressComponents[] dizisiyle ilgili aşağıdaki noktaları göz önünde bulundurun: - Adres bileşenleri dizisi, biçimlendirilmiş adresten daha fazla bileşen içerebilir. - Dizi, formattedAddress'e eklenenler dışında, bir adres içeren tüm siyasi varlıkları içermemelidir. Belirli bir adresi içeren tüm siyasi varlıkları almak için adresin enlem/boylamını parametre olarak isteğe göndererek ters coğrafi kodlama özelliğini kullanmanız gerekir. - Yanıtın 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. Belirli bir bileşen, daha sonraki bir yanıtta 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ı. Bu görüntü alanı, işletmenin fiziksel sınırı veya hizmet bölgesi olarak kullanılmamalıdır.

rating

number

Bu yerle ilgili 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şletmenin ana sayfası). Bir zincirin parçası olan yerler (ör. IKEA mağazası) için bu, genellikle zincirin tamamının değil, tek bir mağazanın web sitesi olur.

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)

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 ekini ekleyerek (ör. ".svg" veya ".png") farklı simge türlerine erişebilir.

iconBackgroundColor

string

Onaltılık biçimdeki icon_mask için arka plan rengi (ör. #909CE1).

currentOpeningHours

object (OpeningHours)

Önümüzdeki yedi gün (bugün dahil) için çalışma saatleri. Dönem, istek tarihinde gece yarısında başlar ve altı gün sonra saat 23:59'da sona erer. Bu alan, istisnai çalışma saatleri olan tarihler için ayarlanan tüm çalışma saatlerinin specialDays alt alanını içerir.

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, türün alt alanını doldurur. Bu alt alan, yer türlerine göre önceden tanımlanmış bir çalışma saatleri türü listesinden (ör. DRIVE_THROUGH, PICKUP veya TAKEOUT) yararlanır. Bu alan, istisnai çalışma saatleri olan tarihler için ayarlanan tüm çalışma saatlerinin specialDays alt alanını içerir.

regularSecondaryOpeningHours[]

object (OpeningHours)

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

editorialSummary

object (LocalizedText)

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

paymentOptions

object (PaymentOptions)

Yerin kabul ettiği ödeme seçenekleri. Ödeme seçeneği verileri mevcut değilse ödeme seçeneği alanı ayarlanmamış olur.

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 bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

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.

containingPlaces[]

object (ContainingPlace)

Mevcut yerin bulunduğu yerlerin listesi.

addressDescriptor

object (AddressDescriptor)

Yerin adres tanımlayıcısı. Adres tanımlayıcıları, bir konumu önemli yerler ve alanlar kullanarak açıklamaya yardımcı olan ek bilgiler içerir. Adres tanımlayıcının bölgesel kapsamını https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage adresinde bulabilirsiniz.

priceRange

object (PriceRange)

Bir yerle ilişkili fiyat aralığı.

utcOffsetMinutes

integer

Bu yerin saat diliminin şu anda UTC'den sapma süresi (dakika cinsinden). Bu değer, saatin kesirli bir kısmı kadar (ör. X saat ve 15 dakika) kaydırılmış saat dilimlerini desteklemek için dakika cinsinden ifade edilir.

userRatingCount

integer

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

takeout

boolean

İşletmenin paket servisi destekleyip desteklemediğini belirtir.

delivery

boolean

İşletmenin teslimatı destekleyip desteklemediğini belirtir.

dineIn

boolean

İşletmenin kapalı veya açık oturma alanı seçeneklerini destekleyip desteklemediğini belirtir.

curbsidePickup

boolean

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

reservable

boolean

Yerin rezervasyonu destekleyip desteklemediğini belirtir.

servesBreakfast

boolean

Tesiste kahvaltı servisi yapılıp yapılmadığını belirtir.

servesLunch

boolean

Mekanda öğle yemeği servisi yapılıp yapılmadığını belirtir.

servesDinner

boolean

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

servesBeer

boolean

Mekanda bira servisi yapılıp yapılmadığını belirtir.

servesWine

boolean

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

servesBrunch

boolean

Geç kahvaltı servisi yapılıp yapılmadığını belirtir.

servesVegetarianFood

boolean

Mekanda vejetaryen yemek servisi olup olmadığını belirtir.

outdoorSeating

boolean

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

liveMusic

boolean

Canlı müzik hizmeti sunan yerler

menuForChildren

boolean

Çocuk menüsü var.

servesCocktails

boolean

Burada kokteyl servisi var.

servesDessert

boolean

Burada tatlı servisi var.

servesCoffee

boolean

Kahve servisi var.

goodForChildren

boolean

Çocuklar için iyi bir yer.

allowsDogs

boolean

Tesiste köpeklere izin veriliyor.

restroom

boolean

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.

pureServiceAreaBusiness

boolean

Yerin yalnızca hizmet bölgesi işletmesi olup olmadığını belirtir. Salt hizmet bölgesi işletmesi, müşterileri doğrudan ziyaret eden veya onlara doğrudan hizmet götüren ancak işletme adresinde müşterilere hizmet vermeyen bir işletmedir. Örneğin, temizlik veya tesisatçılık hizmeti sunan işletmeler. Bu işletmelerin Google Haritalar'da fiziksel adresleri veya konumları olmayabilir.

LocalizedText

Belirli bir dildeki metnin 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").

Daha fazla bilgi için http://www.unicode.org/reports/tr35/#Unicode_locale_identifier adresini ziyaret edin.

AddressComponent

Bu bilgiler mevcutsa 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 ülkesine ait bir adres bileşeninin long_name değeri "Avustralya" olabilir.

shortText

string

Varsa adres bileşeninin kısaltılmış metin adı. Örneğin, Avustralya ülkesine ait bir adres bileşeninin short_name değeri "AU" olabilir.

types[]

string

Adres bileşeninin türlerini belirten bir dizi.

languageCode

string

Bu bileşenleri biçimlendirmek için kullanılan dil (CLDR notasyonu).

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

"9FWM33GV+HQ" gibi yerin küresel (tam) kodu. 1/8000 ile 1/8000 derecelik bir alanı (~14 metreye 14 metre) temsil eder.

compoundCode

string

Yerin birleşik kodu ("33GV+HQ, Ramberg, Norveç" gibi). Bu kod, genel kodun son ekini içerir ve ön eki, referans öğenin biçimlendirilmiş adıyla değiştirir.

LatLng

Bir enlem/boylam çiftini temsil eden nesne. Bu değer, enlem derecelerini ve boylam derecelerini temsil eden bir çift çift olarak ifade edilir. Aksi belirtilmediği sürece 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ı

Çapraz olarak karşı karşıya iki low ve high noktası olarak gösterilen bir enlem-boylam görüntü alanı. Görüntü alanı kapalı bir bölge olarak kabul edilir. Yani görüntü alanı, sınırını içerir. Enlem sınırları -90 ile 90 derece (dahil) arasında, boylam sınırları ise -180 ile 180 derece (dahil) arasında olmalıdır. Bu tür durumlara örnek olarak şunlar verilebilir:

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

  • low.longitude > high.longitude ise boylam aralığı tersine çevrilir (görüntü alanı 180 derece 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ştur.

  • low.latitude > high.latitude ise enlem aralığı boştur.

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

Örneğin, bu görüntü alanı New York'u tamamen kapsıyor:

{ "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 alt noktası.

high

object (LatLng)

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

İncele

Bir yerle ilgili yorum hakkında bilgiler.

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

string

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

relativePublishTimeDescription

string

Yorum zamanını, geçerli saate göre dile ve ülkeye uygun bir biçimde ifade eden biçimlendirilmiş son zaman 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ı. Yıldız sayısı olarak da bilinir.

authorAttribution

object (AuthorAttribution)

Bu yorumun yazarı.

publishTime

string (Timestamp format)

İncelemenin zaman damgası.

RFC3339 UTC "Zulu" biçiminde, nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

flagContentUri

string

Kullanıcıların yorumla ilgili bir sorunu işaretleyebileceği bağlantı.

googleMapsUri

string

Yorumu Google Haritalar'da gösterme bağlantısı.

AuthorAttribution

Kullanıcı tarafından oluşturulan içerik verilerinin yazarı hakkında bilgiler. Kullanıldığı yer: Photo ve Review.

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

string

Photo veya Review'nin yazarının adı.

uri

string

Photo veya Review'un yazarının URI'si.

photoUri

string

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

OpeningHours

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

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

object (Period)

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

weekdayDescriptions[]

string

Bu yerin çalışma saatlerini açıklayan yerelleştirilmiş dizeler (haftanın her günü için birer dize). Çalışma saatleri bilinmiyorsa veya yerelleştirilmiş metne dönüştürülemiyorsa boş olur. Örnek: "Pzt: 18:00-06:00"

secondaryHoursType

enum (SecondaryHoursType)

İkincil saat 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ünlerle ilgili yapılandırılmış bilgiler. Özel günler, bir yerin çalışma saatlerini etkileyebilecek günlerdir (ör. Noel günü). İstisnai çalışma saatleri varsa currentOpeningHours ve currentSecondaryOpeningHours için ayarlayın.

nextOpenTime

string (Timestamp format)

Mevcut çalışma saatleri döneminin gelecekte 7 güne kadar olan bir tarihte tekrar başlaması. Bu alan yalnızca isteğin sunulduğu sırada çalışma saatleri dönemi etkin değilse doldurulur.

RFC3339 UTC "Zulu" biçiminde, nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

nextCloseTime

string (Timestamp format)

Mevcut çalışma saatleri döneminin sona ereceği bir sonraki tarih (7 güne kadar gelecekte). Bu alan yalnızca istek sunulduğu sırada çalışma saatleri dönemi etkinse doldurulur.

RFC3339 UTC "Zulu" biçiminde, nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

openNow

boolean

Çalışma saatleri döneminin şu anda etkin olup olmadığı. Normal çalışma saatleri ve geçerli çalışma saatleri için bu alan, yerin açık olup olmadığı anlamına gelir. İkincil çalışma saatleri ve mevcut ikincil çalışma saatleri için bu alan, bu yerin ikincil çalışma saatlerinin etkin olup olmadığını belirtir.

Dönem

Yerin şu anda açık durumunda kaldığı süre.

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

object (Point)

Yerin açık olmaya başladığı saat.

close

object (Point)

Yerin kapanmaya başladığı saat.

Nokta

Durum değiştirme puanları.

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 sayede, istek tarihinden itibaren en fazla 24 * 7 saat içinde yanıt verilebilir.

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 haneli 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ü). Saat ve saat dilimi başka bir yerde belirtilmiş veya önemsizdir. Tarih, Gregoryen takvimine göredir. Bu durum aşağıdakilerden birini gösterebilir:

  • Sıfır olmayan yıl, ay ve gün değerleri içeren tam tarih.
  • Sıfır yılı olan bir ay ve gün (ör. yıldönümü).
  • Ay ve gün bilgisi olmayan bir yıl.
  • 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 olmadan tarih belirtmek için 0 olmalıdır.

month

integer

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

day

integer

Ayın günü. 1 ile 31 arasında olmalı ve yıl ile ay için geçerli olmalıdır. 0 değerini kullanarak da yıl veya gününün önemli olmadığı bir yıl ve ay belirtebilirsiniz.

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 arabayla geçme saati.
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 Brunch saati.
PICKUP Teslim alma saati.
ACCESS Depolama alanlarının çalışma saatleri.
SENIOR_HOURS Yaşlılara ayrılmış çalışma saatleri.
ONLINE_SERVICE_HOURS Online hizmet saatleri.

SpecialDay

Döndürülen çalışma saatlerinin kapsadığı döneme denk gelen özel günlerle ilgili yapılandırılmış bilgiler. Özel günler, bir yerin çalışma saatlerini etkileyebilecek günlerdir (ör. 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ıyla ilgili bilgiler.

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

string

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

widthPx

integer

Kullanılabilen maksimum genişlik (piksel cinsinden).

heightPx

integer

Kullanılabilen maksimum yükseklik (piksel cinsinden).

authorAttributions[]

object (AuthorAttribution)

Bu fotoğrafın yazarları.

flagContentUri

string

Kullanıcıların fotoğrafla ilgili bir sorunu işaretleyebileceği bir bağlantı.

googleMapsUri

string

Fotoğrafı Google Haritalar'da göstermek için bir bağlantı.

BusinessStatus

Yerin işletme durumu.

Sıralamalar
BUSINESS_STATUS_UNSPECIFIED Varsayılan değer. Bu değer kullanılmamaktadır.
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 Uygun fiyatlı hizmetler sunuluyor.
PRICE_LEVEL_MODERATE Orta düzeyde fiyatlı hizmetler sunuluyor.
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 bilgi.

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ının URI'si.

PaymentOptions

Yerin kabul ettiği ödeme seçenekleri.

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

boolean

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

acceptsDebitCards

boolean

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

acceptsCashOnly

boolean

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

acceptsNfc

boolean

Yer, NFC ödemelerini kabul ediyor.

ParkingOptions

Yerin park yeri 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

Tesiste cadde üzerinde ücretsiz park yeri mevcuttur.

paidStreetParking

boolean

Tesiste ücretli cadde park yeri mevcuttur.

valetParking

boolean

Otelde vale park hizmeti vardır.

freeGarageParking

boolean

Tesiste ücretsiz kapalı otopark mevcuttur.

paidGarageParking

boolean

Tesiste ücretli kapalı otopark mevcuttur.

SubDestination

Yerle ilgili alt hedeflerin yer kaynağı adı ve kimliği. Ö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 varış noktasının 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

Tekerlekli sandalye kullanıcılarına uygun girişi olan yerler.

wheelchairAccessibleRestroom

boolean

Tesiste tekerlekli sandalye kullanıcılarına uygun tuvalet var.

wheelchairAccessibleSeating

boolean

Tekerlekli sandalye kullanıcılarına uygun oturma düzeni var.

FuelOptions

Benzin istasyonundaki yakıt seçenekleri hakkında en güncel bilgiler. Bu bilgiler düzenli olarak güncellenir.

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

object (FuelPrice)

Bu istasyonun sunduğu her yakıt türü için bilinen son yakıt fiyatı. Bu istasyonun sahip olduğu her yakıt türü için bir giriş vardır. Sıralama ö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üncellenme zamanı.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

FuelType

Yakıt türleri.

Sıralamalar
FUEL_TYPE_UNSPECIFIED Belirtilmemiş yakıt türü.
DIESEL Dizel yakıt.
REGULAR_UNLEADED Normal, kurşunsuz.
MIDGRADE Orta.
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.
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ı temsil eder.

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)

Tutardaki tam birimler. Örneğin, currencyCode "USD" ise 1 birim bir ABD doları değerindedir.

nanos

integer

Miktardaki nano (10^-9) birim sayısı. Değer, -999.999.999 ile +999.999.999 arasında (değerler dahil) olmalıdır. units pozitifse nanos pozitif veya sıfır olmalıdır. units sıfır ise nanos pozitif, sıfır veya negatif olabilir. units negatifse nanos negatif veya sıfır olmalıdır. Örneğin, -1,75 ABD doları units=-1 ve nanos=-750.000.000 olarak temsil edilir.

EVChargeOptions

Yerinde barındırılan elektrikli araç şarj istasyonu hakkında bilgi. Terminoloji, https://afdc.energy.gov/fuels/electricity_infrastructure.html adresindeki bilgilere göre belirlenmiştir. Bir bağlantı noktası aynı anda bir aracı şarj edebilir. Bir bağlantı noktasında bir veya daha fazla bağlayıcı bulunur. Bir istasyonda bir veya daha fazla bağlantı noktası bulunur.

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

integer

Bu istasyondaki konnektör sayısı. Ancak bazı bağlantı noktalarında birden fazla bağlayıcı bulunabilir ancak aynı anda yalnızca bir araç şarj edilebilir (ör.). Bu nedenle, bağlayıcı sayısı aynı anda şarj edilebilecek toplam araç sayısından daha fazla olabilir.

connectorAggregation[]

object (ConnectorAggregation)

Aynı tür ve aynı şarj hızına sahip konnektörler içeren elektrikli araç şarj konnektörü toplamalarının listesi.

ConnectorAggregation

[type, maxChargeRateKw] parametrelerine göre gruplandırılmış elektrikli araç şarj bilgileri. Aynı tür ve maksimum şarj hızına (kW) sahip konnektörlerin elektrikli araç ş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 konnektörün sabit maksimum şarj hızı (kW).

count

integer

Bu toplamadaki konnektör sayısı.

availabilityLastUpdateTime

string (Timestamp format)

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

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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ıların 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 Belirtilmemiş bağlayıcı.
EV_CONNECTOR_TYPE_OTHER Diğer konnektör türleri.
EV_CONNECTOR_TYPE_J1772 J1772 tür 1 bağlayıcı.
EV_CONNECTOR_TYPE_TYPE_2 IEC 62196 2. tip konnektör. Genellikle MENNEKES olarak adlandırılır.
EV_CONNECTOR_TYPE_CHADEMO CHAdeMO tipi konnektör.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Birleşik Şarj Sistemi (AC ve DC). SAE'ye göredir. 1. tip J-1772 konnektörü
EV_CONNECTOR_TYPE_CCS_COMBO_2 Birleşik Şarj Sistemi (AC ve DC). Type-2 Mennekes konnektörüne dayalı
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 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 Belirtilmemiş priz.

GenerativeSummary

Deneysel: Daha fazla bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Yapay zeka tarafından üretilen yer özeti.

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

object (LocalizedText)

Yerin genel bakışı.

overviewFlagContentUri

string

Kullanıcıların, genel bakış özetiyle bir sorunu işaretleyebileceği bağlantı.

description

object (LocalizedText)

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

descriptionFlagContentUri

string

Kullanıcıların açıklama özetiyle bir sorunu işaretleyebileceği bağlantı.

references

object (References)

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

Referanslar

Deneysel: Daha fazla bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Üretken içeriğin ilişkili olduğu referans.

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

object (Review)

Referans olarak kullanılabilecek yorumlar.

places[]

string

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

AreaSummary

Deneysel: Daha fazla bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Yerin bulunduğu alanın yapay zeka tarafından oluşturulmuş özeti.

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

object (ContentBlock)

Alan özetini oluşturan içerik blokları. Her blokta, alanla ilgili ayrı bir konu bulunur.

flagContentUri

string

Kullanıcıların özetle ilgili bir sorunu işaretleyebilecekleri bağlantı.

ContentBlock

Tek tek yayınlanabilen 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").

content

object (LocalizedText)

Konuyla ilgili içerik.

references

object (References)

Deneysel: Daha fazla bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Bu içerik bloğuyla ilgili referanslar.

ContainingPlace

Bu yerin bulunduğu yerle ilgili bilgi.

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

string

Bu yerin bulunduğu yerin kaynak adı.

id

string

Bu yerin bulunduğu yerin yer kimliği.

AddressDescriptor

Bir konumun ilişkisel açıklaması. Yakındaki önemli noktalar ve tam kapsayıcı alanlar ile bunların hedef konumla ilişkisini içeren, sıralanmış bir grup içerir.

JSON gösterimi
{
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "areas": [
    {
      object (Area)
    }
  ]
}
Alanlar
landmarks[]

object (Landmark)

Yakındaki önemli yerlerin sıralandığı liste. En tanınmış ve en yakın önemli yerler öncelikli olarak sıralanır.

areas[]

object (Area)

İçerdiği veya bitişik olduğu alanların sıralandığı liste. En belirgin ve hassas bölgeler ilk sırada sıralanır.

Önemli nokta

Temel yer işareti bilgileri ve yer işaretinin hedef konumla ilişkisi.

Yer işaretleri, bir konumu tanımlamak için kullanılabilecek belirgin yerlerdir.

JSON gösterimi
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "spatialRelationship": enum (SpatialRelationship),
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number
}
Alanlar
name

string

Dönüm noktasının kaynak adı.

placeId

string

Simgenin yer kimliği.

displayName

object (LocalizedText)

Dönüm noktasının görünen adı.

types[]

string

Bu yer işareti için bir tür etiket grubu. Olası değerlerin tam listesi için https://developers.google.com/maps/documentation/places/web-service/place-types adresine bakın.

spatialRelationship

enum (SpatialRelationship)

Hedef konum ile yer işareti arasındaki mekansal ilişkiyi tanımlar.

straightLineDistanceMeters

number

Hedefin merkez noktası ile yer işaretinin merkez noktası arasındaki doğrusal mesafe (metre cinsinden). Bazı durumlarda bu değer travelDistanceMeters'ten uzun olabilir.

travelDistanceMeters

number

Biliniyorsa hedeften yola çıkıp anıta giden yol ağındaki seyahat mesafesi (metre cinsinden). Bu değer, yaya, araba veya bisiklet gibi ulaşım şeklini hesaba katmaz.

SpatialRelationship

Hedef konum ile yer işareti arasındaki mekansal ilişkiyi tanımlar.

Sıralamalar
NEAR Aşağıda daha spesifik bir ilişki belirtilmemişse varsayılan ilişki budur.
WITHIN Yer işareti uzamsal bir geometriye sahiptir ve hedef kendi sınırları içindedir.
BESIDE Hedef, işaretin hemen yanındadır.
ACROSS_THE_ROAD Hedef, yolun diğer tarafındaki önemli noktanın tam karşısındadır.
DOWN_THE_ROAD Önemli noktayla aynı rota üzerinde, ancak dışında veya karşısında.
AROUND_THE_CORNER Dönüm noktasıyla aynı rota üzerinde değil, ancak tek bir dönüş uzaklıktadır.
BEHIND Önemli yerin yapısına yakın ancak sokak girişlerinden daha uzak bir yer.

Bölge

Alan bilgileri ve bölgenin hedef konumla ilişkisi.

Alanlar; kesin alt konum, mahalle ve bir konumu açıklamak için yararlı olan büyük yerleşkeleri içerir.

JSON gösterimi
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "containment": enum (Containment)
}
Alanlar
name

string

Alanın kaynak adı.

placeId

string

Alanın yer kimliği.

displayName

object (LocalizedText)

Alanın görünen adı.

containment

enum (Containment)

Hedef konum ile alan arasındaki mekansal ilişkiyi tanımlar.

Kapsama

Hedef konum ile alan arasındaki uzamsal ilişkiyi tanımlar.

Sıralamalar
CONTAINMENT_UNSPECIFIED Kapsama alanı belirtilmedi.
WITHIN Hedef konum, merkeze yakın, alan bölgesi içindedir.
OUTSKIRTS Hedef konum, alan bölgesinde ve kenara yakın bir yerdedir.
NEAR Hedef konum, bölgenin dışında ancak yakında.

PriceRange

Bir yerle ilişkili fiyat aralığı. Üst sınır (ör. "100 ABD dolarından fazla") olmayan aralığı belirten endPrice ayarlanmamış olabilir.

JSON gösterimi
{
  "startPrice": {
    object (Money)
  },
  "endPrice": {
    object (Money)
  }
}
Alanlar
startPrice

object (Money)

Fiyat aralığının alt sınırı (dahil). Fiyat bu tutarda veya bu tutardan yüksek olmalıdır.

endPrice

object (Money)

Fiyat aralığının üst sınırı (hariç). Fiyat bu tutardan düşük olmalıdır.

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 alın.

searchNearby

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

searchText

Metin sorgusuna dayalı yer arama.