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,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "timeZone": {
    object (TimeZone)
  },
  "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 A ve B tablolarına bakın.
primaryType

string

Belirtilen 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 A ve B tablolarına 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 A ve B tablolarına bakın.
nationalPhoneNumber

string

Yerin, ulusal biçimdeki okunabilir telefon numarası.
internationalPhoneNumber

string

Yerin, uluslararası standartta, okunabilir telefon numarası.
formattedAddress

string

Bu yerin tam ve okunabilir adresi.
shortFormattedAddress

string

Bu yerin kısa ve okunabilir adresi.
postalAddress

object (PostalAddress)

Posta adresi biçiminde adres.
addressComponents[]

object (AddressComponent)

Her yerleşim birimi 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 özelliğine dahil edilenler dışında, adres içeren tüm siyasi varlıkları içermeyebilir. 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 sayısı, istenen adrese göre değişir ve aynı adres için zaman içinde değişebilir. Bir bileşen, dizindeki 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 haritada 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 olacaktır.
reviews[]

object (Review)

Bu yerle ilgili 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. Bir yer her zaman açıksa (24 saat) close alanının ayarlanmayacağını unutmayın. İstemciler, her zaman açık (24 saat) değerinin 0 değerine sahip [day][Point.day], 0 değerine sahip [hour][Point.hour] ve 0 değerine sahip [minute][Point.minute] içeren bir [open][google.maps.places.v1.Place.OpeningHours.Period.open] dönemi olarak temsil edilebileceğini bilmelidir.
timeZone

object (TimeZone)

IANA Saat Dilimi Veritabanı saat dilimi. Örneğin, "America/New_York".
photos[]

object (Photo)

Bu yerin fotoğraflarıyla ilgili bilgiler (referanslar dahil). En fazla 10 fotoğraf iade edilebilir.
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 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. Bu süre, isteğin yapıldığı tarihte 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)

Bir işletmenin ikincil çalışma saatleri hakkında bilgiler de dahil olmak üzere önümüzdeki yedi gün için 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, yer türlerine göre önceden tanımlanmış bir çalışma saatleri türü listesinden (ör. DRIVE_THROUGH, PICKUP veya TAKEOUT) alınan tür alt alanını doldurur. 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, yer türlerine göre önceden tanımlanmış bir çalışma saatleri türü listesinden (ör. DRIVE_THROUGH, PICKUP veya TAKEOUT) alınan tür alt alanını doldurur.
editorialSummary

object (LocalizedText)

Yerin özetini içerir. Özet, metin biçiminde bir genel bakıştan oluşur ve varsa bu öğelerin 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)

Tesisin sunduğu otopark seçenekleri.
subDestinations[]

object (SubDestination)

Yerle ilgili alt hedeflerin listesi.
fuelOptions

object (FuelOptions)

Benzin istasyonundaki yakıt seçenekleri hakkında 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.

Yerin yapay zeka tarafından oluşturulmuş özeti.
areaSummary

object (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.
containingPlaces[]

object (ContainingPlace)

Geçerli 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ına göre (ör. X saat ve 15 dakika) kaydırılmış saat dilimlerini desteklemek için dakika cinsinden ifade edilir.
userRatingCount

integer

Bu yerle ilgili 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 alma hizmetini 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

Tesiste akşam yemeği servisi yapılıp yapılmadığını belirtir.
servesBeer

boolean

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

boolean

Mekanda şarap servisi yapılıp yapılmadığı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ı mevcuttur.
liveMusic

boolean

Canlı müzik hizmeti sunan yerler
menuForChildren

boolean

Çocuk menüsü var.
servesCocktails

boolean

Burada kokteyl servisi var.
servesDessert

boolean

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, gruplara uygundur.
goodForWatchingSports

boolean

Burası spor etkinliklerini izlemek için uygun bir yer.
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 bir adresi veya konumu olmayabilir.

LocalizedText

Belirli bir dildeki metnin yerelleştirilmiş varyantı.

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

string

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

string

Metnin BCP-47 dil kodu ("en-US" veya "sr-Latn" gibi).

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

PostalAddress

Posta adresini temsil eder. Örneğin, posta teslimatı veya ödeme adresleri için. Posta hizmetleri, posta adresi verilen bir tesise, posta kutusuna veya benzeri bir yere ürün teslim edebilir. Coğrafi konumları (yollar, kasabalar, dağlar) modellemek için tasarlanmamıştır.

Normal kullanımda, adresler işlem türüne bağlı olarak kullanıcı girişi veya mevcut verilerin içe aktarılmasıyla oluşturulur.

Adres girişi veya düzenlemeyle ilgili öneriler:

  • https://github.com/google/libaddressinput gibi uluslararası kullanıma hazır bir adres widget'ı kullanın.
  • Kullanıcılara, ilgili alanın kullanıldığı ülkeler dışındaki alanların girişi veya düzenlenmesi için kullanıcı arayüzü öğeleri sunulmamalıdır.

Bu şemanın nasıl kullanılacağıyla ilgili daha fazla bilgi için https://support.google.com/business/answer/6397478 adresini ziyaret edin.

JSON gösterimi 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Alanlar
revision

integer

PostalAddress öğesinin şema düzeltmesi. Bu değer, en son düzeltme olan 0 olarak ayarlanmalıdır.

Tüm yeni düzeltmeler, eski düzeltmelerle geriye dönük uyumlu olmalıdır.
regionCode

string

Zorunlu. Adresin bulunduğu ülke/bölgenin CLDR bölge kodu. Bu durum hiçbir zaman çıkarılmaz ve değerin doğru olduğundan emin olmak kullanıcıya bağlıdır. Ayrıntılar için https://cldr.unicode.org/ adresine bakın ve https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html dosyasını indirin. Örnek: İsviçre için "CH".
languageCode

string

İsteğe bağlı. Bu adresin içeriğinin BCP-47 dil kodu (biliniyorsa). Bu, genellikle giriş formunun kullanıcı arayüzü dilidir veya adresin ülkesinde/bölgesinde kullanılan dillerden biriyle veya bunların transkript eşdeğerleriyle eşleşmesi beklenir. Bu durum, belirli ülkelerdeki biçimlendirmeyi etkileyebilir ancak verilerin doğruluğu açısından kritik değildir ve hiçbir zaman doğrulama işlemlerini veya biçimlendirmeyle ilgili olmayan diğer işlemleri etkilemez.

Bu değer bilinmiyorsa yanlış olabilecek bir varsayılan değer belirtmek yerine atlanmalıdır.

Örnekler: "zh-Hant", "ja", "ja-Latn", "en".
postalCode

string

İsteğe bağlı. Adresin posta kodu. Posta kodları her ülkede kullanılmaz veya zorunlu tutulmaz ancak kullanıldıkları yerlerde adresin diğer bölümleriyle birlikte ek doğrulama tetiklenebilir (ör. ABD'de eyalet/posta kodu doğrulaması).
sortingCode

string

İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Bu, çoğu bölgede kullanılmaz. Kullanıldığı yerlerde değer, "CEDEX" gibi bir dizedir ve isteğe bağlı olarak bir sayı (ör. "CEDEX 7") ekler veya "sektör kodu"nu (Jamaika), "teslimat bölgesi göstergesini" (Malavi) ya da "posta ofisi göstergesini" (ör. Fildişi Sahili) temsil eden tek bir sayıdır.
administrativeArea

string

İsteğe bağlı. Bir ülke veya bölgenin posta adresleri için kullanılan en yüksek idari alt birim. Örneğin, bu bir eyalet, il, oblast veya idari bölge olabilir. İspanya'da bu, özerk topluluk değil ildir (örneğin, "Katalonya" değil "Barselona"). Birçok ülkede posta adreslerinde idari bölge kullanılmaz. Örneğin İsviçre'de bu alan doldurulmamalıdır.
locality

string

İsteğe bağlı. Genellikle adresin şehir/kasaba kısmını ifade eder. Örnekler: ABD'de şehir, İtalya'da komün, Birleşik Krallık'ta posta bölgesi. Yerelliklerin iyi tanımlanmadığı veya bu yapıya iyi uymadığı dünyanın bölgelerinde, locality alanını boş bırakın ve addressLines alanını kullanın.
sublocality

string

İsteğe bağlı. Adresin alt mahallesi. Örneğin, mahalleler, semtler, ilçeler bu kapsamdadır.
addressLines[]

string

Bir adresin alt düzeylerini açıklayan yapılandırılmamış adres satırları.

addressLines içindeki değerler tür bilgisine sahip olmadığı ve bazen tek bir alanda birden çok değer içerebildiğinden (ör. "Austin, TX"), satır sırasının net olması önemlidir. Adres satırlarının sırası, adresin bulunduğu ülke/bölge için "zarf sırası" olmalıdır. Bunun değişebileceği yerlerde (ör. Japonya) bunu açıkça belirtmek için address_language kullanılır (ör. büyükten küçüğe sıralama için "ja" ve küçükten büyüğe sıralama için "ja-Latn" veya "en"). Bu sayede, bir adresin en spesifik satırı dile göre seçilebilir.

Bir adresin izin verilen minimum yapısal temsili, regionCode ile diğer tüm bilgilerin addressLines içine yerleştirilmesinden oluşur. Bu tür bir adres, coğrafi kodlama olmadan çok yaklaşık olarak biçimlendirilebilir ancak en azından kısmen çözülene kadar adres bileşenlerinden hiçbiri hakkında anlamsal bir çıkarım yapılamaz.

Tamamen yapılandırılmamış adresleri işlemek için önerilen yöntem, yalnızca regionCode ve addressLines içeren bir adres oluşturmak ve ardından coğrafi kodlama yapmaktır (adresin hangi bölümlerinin yerel yönetim bölgeleri veya idari bölgeler olması gerektiğini tahmin etmek yerine).
recipients[]

string

İsteğe bağlı. Adresteki alıcı. Bu alan, belirli durumlarda çok satırlık bilgiler içerebilir. Örneğin, "teslim edilecek kişi" bilgilerini içerebilir.
organization

string

İsteğe bağlı. Adresteki kuruluşun adı.

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şeni için 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

Plus code (http://plus.codes), iki biçime sahip bir konum referansı: 14 m x 14 m (derecenin 1/8000'i) veya daha küçük bir dikdörtgeni tanımlayan genel kod ve ön eki referans konumla değiştiren birleş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ı (~14x14 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

Enlem (derece cinsinden). [-90,0; +90,0] aralığında olmalıdır.
longitude

number

Boylam (derece cinsinden). [-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. Çeşitli durumlar şunlardır:

  • low = high ise görüntü alanı tek bir 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ş bir görüntü alanı hataya neden olur.

Ö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ı.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
flagContentUri

string

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

string

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

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'un 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, yer yerel saat diliminde Pazar gününden başlayarak kronolojik sırayla gösterilir. Boş (ancak mevcut olmayan) bir değer, hiçbir zaman açık olmayan bir yeri (ör. tadilat nedeniyle geçici olarak kapalı) gösterir.
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ülemediyse boş olur. Örnek: "Pzt: 18:00-06:00"
secondaryHoursType

enum (SecondaryHoursType)

İkincil saat türlerini 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ünlere ilişkin 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 istek sunulduğu sırada çalışma saatleri dönemi etkin değilse doldurulur.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
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.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
openNow

boolean

Çalışma saatleri döneminin şu anda etkin olup olmadığı. Normal çalışma saatleri ve mevcut çalışma saatleri için bu alan, yerin açık olup olmadığını belirtir. İ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 dilimine göre tarih.
truncated

boolean

Bu uç noktanın kısaltılıp kısaltılmadığını belirtir. Gerçek saatler, döndürmek istediğimiz saatler aralığının dışında olduğunda saatler kısaltılır. Bu nedenle, saatler bu sınırlara göre kısaltılır. 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 günü. 0 Pazar, 1 Pazartesi vb.
hour

integer

24 saat biçiminde saat. 0 ile 23 arasında değişir.
minute

integer

Bir dakika. 0 ile 59 arasında değişir.

Tarih

Doğum günü gibi takvim tarihlerinin tamamını veya bir kısmını temsil eder. 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 (ör. kredi kartının 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 ve 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 ö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ünlere ilişkin 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.

TimeZone

IANA Saat Dilimi Veritabanı'ndaki bir saat dilimini temsil eder.

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

string

IANA Saat Dilimi Veritabanı saat dilimi. Örneğin, "America/New_York".
version

string

İsteğe bağlı. IANA Saat Dilimi Veritabanı sürüm numarası. Örneğin, "2019a".

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 faaliyettedir ancak ş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 Yer fiyat düzeyi belirtilmemiş veya bilinmiyor.
PRICE_LEVEL_FREE Tesis ücretsiz hizmetler sunuyor.
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

Tesiste ücretsiz otopark mevcuttur.
paidParkingLot

boolean

Tesiste ücretli otopark mevcuttur.
freeStreetParking

boolean

Tesiste cadde üzerinde ücretsiz park yeri mevcuttur.
paidStreetParking

boolean

Tesiste ücretli cadde park yeri mevcuttur.
valetParking

boolean

Tesiste vale park hizmeti sunulur.
freeGarageParking

boolean

Tesiste ücretsiz kapalı otopark mevcuttur.
paidGarageParking

boolean

Tesiste ücretli kapalı otopark mevcuttur.

SubDestination

Alt hedefler, ana bir yerle ilişkili belirli yerlerdir. Bu sonuçlar, havaalanı, milli park, üniversite veya stadyum gibi büyük veya karmaşık bir yer arayan kullanıcılara daha spesifik hedefler sunar. Örneğin, bir havalimanındaki alt hedefler, ilişkili terminalleri ve otoparkları içerebilir. Alt hedefler, yer kimliğini ve yer kaynağı adını döndürür. Bu bilgiler, alt hedefin görünen adı ve konumu da dahil olmak üzere daha zengin ayrıntılar almak için sonraki Yer Ayrıntıları (Yeni) isteklerinde kullanılabilir.

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

Tekerlekli sandalye kullanıcılarına uygun park yeri 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ı.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

FuelType

Yakıt türleri.

Sıralamalar
FUEL_TYPE_UNSPECIFIED Yakıt türü belirtilmedi.
DIESEL Dizel yakıt.
DIESEL_PLUS Dizel ve 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 Sıvılaştırılmış Petrol Gazı.
E80 E 80.
E85 E 85.
E100 E 100.
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

Miktarın nano (10^-9) birimi 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

Yerde 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ı.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
availableCount

integer

Bu toplamadaki şu anda kullanılabilir durumdaki bağlayıcıların 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 1. tip konnektör.
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öre. 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ü değil, Tesla markalı bir aracı Tesla'nın sahip olduğu bir şarj istasyonunda şarj etme özelliğini 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.
EV_CONNECTOR_TYPE_NACS SAE J3400 olarak standartlaştırılmış Kuzey Amerika Şarj Sistemi (NACS).

GenerativeSummary

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

Yerin yapay zeka tarafından oluşturulmuş özeti.

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

object (LocalizedText)

Yerle ilgili 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şaretleyebileceği 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çerikler.
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 yer hakkında 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 tanınabilir ve hassas alanlar öncelikli olarak 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)

Önemli yerin 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 Dönüm noktası, bir mekansal geometriye sahiptir ve hedef, bu geometrinin sınırları içindedir.
BESIDE Hedef, işaretin hemen yanındadır.
ACROSS_THE_ROAD Hedef, yolun diğer tarafındaki yer işaretinin tam karşısındadır.
DOWN_THE_ROAD Dönüm noktasıyla aynı rota üzerinde ancak yanında veya karşısında değil.
AROUND_THE_CORNER Dönüm noktasıyla aynı rota üzerinde değil, tek bir dönüş uzaklıkta.
BEHIND Önemli yerin yapısına yakın ancak sokak girişlerinden daha uzak bir yer.

Bölge

Alan bilgileri ve alanın hedef konumla ilişkisi.

Alanlar, bir konumu tanımlamak için yararlı olan kesin alt mahalle, mahalle ve büyük yerleşim birimlerini 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 mekansal ilişkiyi tanımlar.

Sıralamalar
CONTAINMENT_UNSPECIFIED Kapsayıcılık belirtilmedi.
WITHIN Hedef konum, alan bölgesinde ve merkeze yakındır.
OUTSKIRTS Hedef konum, alan bölgesinde, kenara yakın bir yerdedir.
NEAR Hedef konum, alan bölgesinin dışında ancak yakınındadır.

PriceRange

Bir yerle ilişkili fiyat aralığı. endPrice ayarlanmamış olabilir.Bu, üst sınırı olmayan bir aralığı (ör. "100 TL'den fazla") gösterir.

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

 Belirli bir giriş için 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.