Yer Ayrıntıları (eski)

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Yer arama işleminden place_id aldıktan sonra, Yer Ayrıntıları (Eski) isteği başlatarak belirli bir kuruluş veya önemli yer hakkında daha fazla ayrıntı isteyebilirsiniz. Yer Ayrıntıları (Eski) isteği, belirtilen yerle ilgili daha kapsamlı bilgiler (ör. tam adresi, telefon numarası, kullanıcı puanı ve yorumları) döndürür.

Yer Ayrıntıları (Eski) istekleri

Yer Ayrıntıları (Eski) isteği, aşağıdaki biçimde bir HTTP URL'sidir:

https://maps.googleapis.com/maps/api/place/details/output?parameters

Burada output aşağıdaki değerlerden biri olabilir:

  • json (önerilir) JavaScript Object Notation (JSON) biçiminde çıktı olduğunu gösterir.
  • xml, çıkışın XML olarak gösterileceğini belirtir.

Arama isteği başlatmak için belirli parametreler gereklidir. URL'lerde standart olduğu gibi, tüm parametreler "ve" işareti (&) kullanılarak ayrılır. Aşağıda parametrelerin ve olası değerlerinin listesi yer almaktadır.

Gerekli parametreler

  • place_id

    Bir yeri benzersiz şekilde tanımlayan ve Yer Arama'dan döndürülen metin tanımlayıcısı. Yer kimlikleri hakkında daha fazla bilgi için Yer kimliğine genel bakış başlıklı makaleyi inceleyin.

İsteğe bağlı parametreler

  • Fields

    Dikkat: Yer Arama istekleri ve Yer Ayrıntıları istekleri aynı alanları döndürmez. Yer Arama istekleri, Yer Ayrıntıları istekleri tarafından döndürülen alanların bir alt kümesini döndürür. İstediğiniz alan Yer Arama tarafından döndürülmüyorsa place_id almak için Yer Arama'yı kullanabilir, ardından Yer Ayrıntıları isteği göndermek için bu yer kimliğini kullanabilirsiniz. Yer Arama isteğinde kullanılamayan alanlar hakkında daha fazla bilgi için Places API alan desteği başlıklı makaleyi inceleyin.

    Döndürülecek virgülle ayrılmış yer verisi türleri listesini belirtmek için fields parametresini kullanın. Örneğin: fields=formatted_address,name,geometry. Bileşik değerleri belirtirken eğik çizgi kullanın. Örneğin: opening_hours/open_now.

    Alanlar üç faturalandırma kategorisine ayrılır: Temel, Kişi ve Atmosfer. Temel, Kişi ve Atmosfer SKU'ları, bunları tetikleyen istek için temel SKU'ya (Yer Ayrıntıları, Yer Bulma, Yakında Arama veya Metin Arama) ek olarak ücretlendirilir. Daha fazla bilgi için fiyatlandırma sayfasını inceleyin.

    Temel

    Temel kategoride şu alanlar bulunur: address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (desteği sonlandırılmış), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

    İletişim

    Kişi kategorisi aşağıdaki alanları içerir: current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website

    Atmosfer

    Atmosfer kategorisi aşağıdaki alanları içerir: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, user_ratings_total.

    Not: Alan istenmiş olsun veya olmasın, atıflar html_attributions her zaman her aramada döndürülür.

  • language

    Sonuçların döndürüleceği dil.

    • Desteklenen dillerin listesini inceleyin. Google, desteklenen dilleri sık sık güncellediği için bu liste kapsamlı olmayabilir.
    • language sağlanmazsa API, Accept-Language üstbilgisinde belirtilen tercih edilen dili kullanmaya çalışır.
    • API, hem kullanıcı hem de yerel halk tarafından okunabilir bir açık adres sağlamak için elinden geleni yapar. Bu hedefi gerçekleştirmek için tercih edilen dili dikkate alarak gerekirse kullanıcının okuyabileceği bir alfabeye çevrilmiş, yerel dildeki açık adresleri döndürür. Diğer tüm adresler tercih edilen dilde döndürülür. Adres bileşenlerinin tümü aynı dilde döndürülür. Bu dil, ilk bileşenden seçilir.
    • Bir ad tercih edilen dilde kullanılamıyorsa API en yakın eşleşmeyi kullanır.
    • Tercih edilen dil, API'nin döndürmeyi seçtiği sonuç kümesi ve bu sonuçların döndürülme sırası üzerinde küçük bir etkiye sahiptir. Coğrafi kodlayıcı, kısaltmaları dile bağlı olarak farklı yorumlar. Örneğin, sokak türlerinin kısaltmaları veya bir dilde geçerli olup başka bir dilde geçerli olmayan eş anlamlılar. Örneğin, Macarca'da utca ve tér, sokak kelimesinin eş anlamlılarıdır.

  • bölge

    ccTLD ("üst düzey alan") olarak belirtilen bölge kodu, iki karakterli bir değerdir. Çoğu ccTLD kodu, ISO 3166-1 kodlarıyla aynıdır. Ancak bazı önemli istisnalar vardır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk), ISO 3166-1 kodu ise "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" tüzel kişiliği için).

  • reviews_no_translations

    Yorumların çevirisini devre dışı bırakmak için reviews_no_translations=true, etkinleştirmek için reviews_no_translations=false değerini belirtin. Yorumlar orijinal dillerinde döndürülür.

    Atlanırsa veya değer olmadan iletilirse yorumların çevirisi etkinleştirilir. İstek içinde language parametresi belirtilmişse çeviri için tercih edilen dil olarak belirtilen dili kullanın. language boş bırakılırsa API, tercih edilen dil olarak Accept-Language üstbilgisini kullanmaya çalışır.

  • reviews_sort

    Yorumlar döndürülürken kullanılacak sıralama yöntemi. Şu şekilde ayarlanabilir: most_relevant (varsayılan) veya newest.

    • most_relevant (varsayılan) için yorumlar alaka düzeyine göre sıralanır. Hizmet, sonuçları tercih edilen dilde yazılmış yorumları döndürecek şekilde yönlendirir.
    • newest için yorumlar kronolojik sıraya göre sıralanır. Tercih edilen dil, sıralama düzenini etkilemez.

    Google, yorumların nasıl sıralandığını son kullanıcıya göstermenizi önerir.

  • sessiontoken

    Faturalandırma amacıyla bir otomatik tamamlama oturumunu tanımlayan rastgele bir dize.

    Oturum, kullanıcının sorgu yazmaya başlamasıyla başlar ve bir yer seçip Yer Ayrıntıları çağrısı yapmasıyla sona erer. Her oturumda birden fazla sorgu ve ardından bir yer seçimi olabilir. Bir oturumdaki her istek için kullanılan API anahtarları aynı Google Cloud Console projesine ait olmalıdır. Bir oturum sona erdiğinde jeton artık geçerli olmaz. Uygulamanız her oturum için yeni bir jeton oluşturmalıdır. sessiontoken parametresi atlanırsa veya oturum jetonu yeniden kullanılırsa oturum, oturum jetonu sağlanmamış gibi ücretlendirilir (her istek ayrı olarak faturalandırılır).

    Aşağıdaki yönergeleri uygulamanızı öneririz:

    • Tüm otomatik tamamlama oturumları için oturum jetonlarını kullanın.
    • Her oturum için yeni bir jeton oluşturun. Sürüm 4 UUID kullanmanız önerilir.
    • Bir oturumdaki tüm Yer Adı Otomatik Tamamlama ve Yer Ayrıntıları istekleri için kullanılan API anahtarlarının aynı Cloud Console projesine ait olduğundan emin olun.
    • Her yeni oturum için benzersiz bir oturum jetonu ilettiğinizden emin olun. Birden fazla oturum için aynı jetonun kullanılması, her isteğin ayrı ayrı faturalandırılmasına neden olur.

Yer ayrıntıları (eski) örneği

Aşağıdaki örnekte, place_id ile bir yerin ayrıntıları istenmekte ve name, rating ve formatted_phone_number alanları eklenmektedir:

kabuk

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating%2Cformatted_phone_number&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/details/json
  ?fields=name%2Crating%2Cformatted_phone_number
  &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4
  &key=YOUR_API_KEY

İsteğin uygulamanızda çalışması için bu örnekteki anahtarı kendi API anahtarınızla değiştirmeniz gerektiğini unutmayın.

Yer Ayrıntıları (Eski) yanıtı

Yer Ayrıntıları (Eski) yanıtları, isteğin URL yolundaki output işaretiyle belirtilen biçimde döndürülür.

JSON

{
  "html_attributions": [],
  "result":
    {
      "address_components":
        [
          { "long_name": "48", "short_name": "48", "types": ["street_number"] },
          {
            "long_name": "Pirrama Road",
            "short_name": "Pirrama Rd",
            "types": ["route"],
          },
          {
            "long_name": "Pyrmont",
            "short_name": "Pyrmont",
            "types": ["locality", "political"],
          },
          {
            "long_name": "City of Sydney",
            "short_name": "City of Sydney",
            "types": ["administrative_area_level_2", "political"],
          },
          {
            "long_name": "New South Wales",
            "short_name": "NSW",
            "types": ["administrative_area_level_1", "political"],
          },
          {
            "long_name": "Australia",
            "short_name": "AU",
            "types": ["country", "political"],
          },
          {
            "long_name": "2009",
            "short_name": "2009",
            "types": ["postal_code"],
          },
        ],
      "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "business_status": "OPERATIONAL",
      "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "formatted_phone_number": "(02) 9374 4000",
      "geometry":
        {
          "location": { "lat": -33.866489, "lng": 151.1958561 },
          "viewport":
            {
              "northeast":
                { "lat": -33.8655112697085, "lng": 151.1971156302915 },
              "southwest":
                { "lat": -33.86820923029149, "lng": 151.1944176697085 },
            },
        },
      "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
      "icon_background_color": "#7B9EB0",
      "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
      "international_phone_number": "+61 2 9374 4000",
      "name": "Google Workplace 6",
      "opening_hours":
        {
          "open_now": false,
          "periods":
            [
              {
                "close": { "day": 1, "time": "1700" },
                "open": { "day": 1, "time": "0900" },
              },
              {
                "close": { "day": 2, "time": "1700" },
                "open": { "day": 2, "time": "0900" },
              },
              {
                "close": { "day": 3, "time": "1700" },
                "open": { "day": 3, "time": "0900" },
              },
              {
                "close": { "day": 4, "time": "1700" },
                "open": { "day": 4, "time": "0900" },
              },
              {
                "close": { "day": 5, "time": "1700" },
                "open": { "day": 5, "time": "0900" },
              },
            ],
          "weekday_text":
            [
              "Monday: 9:00 AM – 5:00 PM",
              "Tuesday: 9:00 AM – 5:00 PM",
              "Wednesday: 9:00 AM – 5:00 PM",
              "Thursday: 9:00 AM – 5:00 PM",
              "Friday: 9:00 AM – 5:00 PM",
              "Saturday: Closed",
              "Sunday: Closed",
            ],
        },
      "photos":
        [
          {
            "height": 3024,
            "html_attributions":
              [
                "Cynthia Wei",
              ],
            "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX",
            "width": 4032,
          },
          {
            "height": 3264,
            "html_attributions":
              [
                "Heyang Li",
              ],
            "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI",
            "width": 4912,
          },
          {
            "height": 3036,
            "html_attributions":
              [
                "Anna Linetsky",
              ],
            "photo_reference": "Aap_uEAumTzSdhRHDutPAj6wVPSZZmBV-brI6TPFwI0tcQlbSR74z44mUPr4aXMQKck_AzHaKmbfR3P2c1qsu45i1RQPHrcpIXxrA78FmDjCdWYYZWUnFozdcmEj9OQ_V0G08adpKivMKZyeaQ1NuwRy9GhSopeKpzkzkFZG5vXMYPPSgpa1",
            "width": 4048,
          },
          {
            "height": 4016,
            "html_attributions":
              [
                "Jonah Dell",
              ],
            "photo_reference": "Aap_uECC7cSbDkh-TdmXr6m5d5pgVXJmvXg8dF2jzhL0b0Ko4CtnVll6-tIvdz7vhbCsd3hl2u9EgZ4Y30FBxKmFcimfeYUgW2XJyv8JY5IYGuXsKkCLqpV3QH9dIGwoUv2uX0eosDsUsTN2DOlyOasUgVxcYqzIzEmrL5ofIssThQWZeozD",
            "width": 6016,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Anthony Huynh",
              ],
            "photo_reference": "Aap_uEDTdw58CglFmZZAR9iZ05x3y2oK9r5_dRqKWnbZKSS9gs6gp9AeBa1QDvBL6dzZyQAZfN8H2Eppu6y4NBaPOp-GkulZYiKRM7Yww8sUEv-8dmcq35Tx38pe4LEX2wIicFkQHedRgMc0FfV9aFtgosQ5ps5-HCjJSApg8eLGyuxxqPm9",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jasen Baker",
              ],
            "photo_reference": "Aap_uEAGqslqZPhZUk0T2Y6l7mkCYnY7JN9li4g5NkZsE0N4Cdy7_cZ-fZWyV02VhpQR4Ph4fLUL6_WTXrlGMXXzUJXUcSmSTs2d_Dzf3Q_A1y07Dm-vtv7pS3JXsWyrWETGIoT1pIj81PPdUc1vlR2i3GFMWAbx9rCC472ZJclY8JlvMg-x",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBaGxeN90YFjD-AUjxZqM44kpMcICKKBBhb0RQQS7DHHFaay8RRAwjWsAt8GEmmB5QnxrbQWHU3TwhVXXHP0m-YNp9Ds3ihpiFan0moNv4QB7kern5cfjWhhrWe8B0dz_vYvmPssJE24P-24YfWWHubOo0L2MjQyueZfDv57N_RvDZk",
            "width": 4032,
          },
          {
            "height": 1515,
            "html_attributions":
              [
                "Andrew W",
              ],
            "photo_reference": "Aap_uEBDzJlmTeNUreMop6_hkC1HKTCRLyPs5fikJi58qCejtkWp5PIM6vzNN3HErkSWUwnamTr_WLyT7jXMAIdByR-hx8dG-OHjj5JxzmcPvuT_VeVLmdSbNPeIlpmp6EUcPOhaVrhEKojSd44QXkl0za29eZ0oj1KDOnAsGxmhanDFW7lI",
            "width": 2048,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBvYFpzCDQzvQ0kdBxxB70lTkLbTM0yH3xF-BCHsb7DQ63cuWnutvwv8oVLDSbA14_kns3WVlEInTyy2elvmH5lzQteb6zzRu3exkwE65_55TgJqdLO7RYYiPFliWk4ocszn9nn5ELv5uP2BQmqr9QET5vwgxR-0eshyVmcdM42jb39",
            "width": 4032,
          },
          {
            "height": 4032,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uECQynuD_EnSnbz8sJQ6-B6uR-j2tuu4Z1tuGUjq8xnxFDk-W8OdeLzWBX8suNKTCsPlkzTqC22BXf_hX33XclGPL4SS9xnPmHcMrLoUl0H_xHYevFvT17Hgw5DZpSyVmLvDvxzzJ1rsZTh55QwopmAty083a1r1ZIfL32iXh_q8FUas",
            "width": 3024,
          },
        ],
      "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "plus_code":
        {
          "compound_code": "45MW+C8 Pyrmont NSW, Australia",
          "global_code": "4RRH45MW+C8",
        },
      "rating": 4,
      "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "reviews":
        [
          {
            "author_name": "Luke Archibald",
            "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "a week ago",
            "text": "Beautiful building with a great view.",
            "time": 1652286798,
          },
          {
            "author_name": "Tevita Taufoou",
            "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "6 months ago",
            "text": "Conference rooms were well equipped.",
            "time": 1637215605,
          },
          {
            "author_name": "Jordy Baker",
            "author_url": "https://www.google.com/maps/contrib/102582237417399865640/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The staff is very friendly.",
            "time": 1641389490,
          },
          {
            "author_name": "Prem Rathod",
            "author_url": "https://www.google.com/maps/contrib/115981614018592114142/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The location is convenient and easy to find.",
            "time": 1640159655,
          },
          {
            "author_name": "Husuni Hamza",
            "author_url": "https://www.google.com/maps/contrib/102167316656574288776/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo",
            "rating": 5,
            "relative_time_description": "7 months ago",
            "text": "A modern and impressive facility.",
            "time": 1633197305,
          },
        ],
      "types": ["point_of_interest", "establishment"],
      "url": "https://maps.google.com/?cid=10281119596374313554",
      "user_ratings_total": 939,
      "utc_offset": 600,
      "vicinity": "48 Pirrama Road, Pyrmont",
      "website": "http://google.com/",
    },
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceDetailsResponse>
 <status>OK</status>
 <result>
  <name>Google Workplace 6</name>
  <vicinity>48 Pirrama Road, Pyrmont</vicinity>
  <type>point_of_interest</type>
  <type>establishment</type>
  <formatted_phone_number>(02) 9374 4000</formatted_phone_number>
  <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, Australia</formatted_address>
  <address_component>
   <long_name>48</long_name>
   <short_name>48</short_name>
   <type>street_number</type>
  </address_component>
  <address_component>
   <long_name>Pirrama Road</long_name>
   <short_name>Pirrama Rd</short_name>
   <type>route</type>
  </address_component>
  <address_component>
   <long_name>Pyrmont</long_name>
   <short_name>Pyrmont</short_name>
   <type>locality</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>City of Sydney</long_name>
   <short_name>City of Sydney</short_name>
   <type>administrative_area_level_2</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>New South Wales</long_name>
   <short_name>NSW</short_name>
   <type>administrative_area_level_1</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>Australia</long_name>
   <short_name>AU</short_name>
   <type>country</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>2009</long_name>
   <short_name>2009</short_name>
   <type>postal_code</type>
  </address_component>
  <geometry>
   <location>
    <lat>-33.8664890</lat>
    <lng>151.1958561</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8682092</lat>
     <lng>151.1944177</lng>
    </southwest>
    <northeast>
     <lat>-33.8655113</lat>
     <lng>151.1971156</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <url>https://maps.google.com/?cid=10281119596374313554</url>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference>
  <international_phone_number>+61 2 9374 4000</international_phone_number>
  <website>http://google.com/</website>
  <review>
   <time>1652286798</time>
   <text>Beautiful building with a great view.</text>
   <author_name>Luke Archibald</author_name>
   <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>a week ago</relative_time_description>
  </review>
  <review>
   <time>1637215605</time>
   <text>Conference rooms were well equipped.</text>
   <author_name>Joe Schmoe</author_name>
   <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>6 months ago</relative_time_description>
  </review>
  <review>
   <time>1641389490</time>
   <text>The staff is very friendly.</text>
   <author_name>Jordy Baker</author_name>
   <author_url>https://www.google.com/maps/contrib/102582237417399865640/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1640159655</time>
   <text>The location is convenient and easy to find.</text>
   <author_name>Prem Rathod</author_name>
   <author_url>https://www.google.com/maps/contrib/115981614018592114142/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1633197305</time>
   <text>A modern and impressive facility.</text>
   <author_name>Husuni Hamza</author_name>
   <author_url>https://www.google.com/maps/contrib/102167316656574288776/reviews</author_url>
   <rating>5.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>7 months ago</relative_time_description>
  </review>
  <opening_hours>
   <open_now>false</open_now>
   <period>
    <open>
     <day>1</day>
     <time>0900</time>
    </open>
    <close>
     <day>1</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>2</day>
     <time>0900</time>
    </open>
    <close>
     <day>2</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>3</day>
     <time>0900</time>
    </open>
    <close>
     <day>3</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>4</day>
     <time>0900</time>
    </open>
    <close>
     <day>4</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>5</day>
     <time>0900</time>
    </open>
    <close>
     <day>5</day>
     <time>1700</time>
    </close>
   </period>
   <weekday_text>Monday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Tuesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Wednesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Thursday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Friday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Saturday: Closed</weekday_text>
   <weekday_text>Sunday: Closed</weekday_text>
  </opening_hours>
  <utc_offset>600</utc_offset>
  <photo>
   <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/117600448889234589608&quot;&gt;Cynthia Wei&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference>
   <width>4912</width>
   <height>3264</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102493344958625549078&quot;&gt;Heyang Li&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBXOmqXNblj10HJavekmUNyUwccggfNN9KVE9TjYcU9HXkBHdvnwfYHDx3dfrjJJwnN8yooP-5412iJNRk8cwUbAVYbD2326cfiJJ3oK6pOrAi1oBmCYuAwKTHnX3EQvSbheVhJZPNDHlT5TjKcwfwAb80eyLB2UNyWl3Y6D7YS7ZSf</photo_reference>
   <width>4048</width>
   <height>3036</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/104829437842034782235&quot;&gt;Anna Linetsky&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAWyGsK1fp3SE73xICq8FJNlrVVqRk8E6YfMiz-o8IJj1vESmuDj4NnPDP4S2kWFrfoBpqw9lmXBGxtYo6nPMySfBAcRIbdEg0ko4dcdzsBvo6cRUz9XpmlcoptCpIAKEb6f7Bh_OD0zFntYbTz-pLdQ9ZHB8tBvTb3kzfTdK2Du0yC</photo_reference>
   <width>6016</width>
   <height>4016</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/107755640736541028674&quot;&gt;Jonah Dell&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAxbn61tx1hwCo3kUMd2KPlWaBkrFhXHxsZDgkYxpJqc-ZYC6U0MH6urfbHVrwmMoosOG0G39anmR68B7p2Up3AACxTa21vCopSL6-RHIphVsBhfhOrFMlGNqBDEsnmY15X0FzzNMKASXqmqtzBphiRyGhAFKfRs3Js1ymXP_FWjqzT</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/115886271727815775491&quot;&gt;Anthony Huynh&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEClwnjuvgS58OknaXxZeVGf5ydyG6U6lO9srr8FU7tPoZ4DvqQo-GUeemssC11tzDBUMWit4ILWF-GmlRfIHS8FuAtttOgp2wvgPhs-ADUrznLRXYKBRkNQnRLEIA1PBgJN9Eev8tFWxpY_jBMklkEUZJRjm-mk9R0bSKSelpPgMYAz</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102939237947063969663&quot;&gt;Jasen Baker&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBvISYtwjSgTQntTJJ_-XhPUF4CVCQF3wxM0FjcQJuzomYLfZWFlIWsOgXhwt2Sd8K6OqFrSP8XHHrBaqQJHD-om-H_wfRLVmiAoQa8QG5oxt540AucTMP4H2QfhTXngqEoNuOcbb-xo2l01OPUetTdIZQ3S6U5s2iyGrHpTs3qz8CH</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEB2cYxbKE7uIXQ_IhX3TvZHDcFHXjWSwezoiwP3eWlfIDTWwq3xtsYZY7QSrhR2d9s1eWmZlM5zr9iHlC_n0gsJXNeRcfd2JjuLFaNuC7VfpeIsdQchhOybG0drJ2CxzD187Az-Foip-6MutDA22LINPw0Iyc_yT04WbxQDxhiwu2Cn</photo_reference>
   <width>2048</width>
   <height>1515</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112343109286948028063&quot;&gt;Andrew W&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBJyLgeilgow1JnoKW83IBsl8CPkmryN8nGYtBzzLaiLjFicWxC1YPQusM-_Fvfb1bkbuShrzjXmHCOp5HoBgJsgit8o0HPYWgjSwrdySqde1BgfKbwS-TWbPg_dwTnVR8LrVPxa_vpLzNlx1b-WpDZo3-_KvxH2GARhVrcvWkvMYD0</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEADyMSxLevgbLWCJeHA8kIN3w6-JcndbuHvTB0oqR-IlWbml4bbYmR-_iYU15HBh8xi3w5hZ455pda6m-BlLCscr6g_Zc5FmBOHW56IsZF3Pxif5UmeGZSsg3WIjHCoL-JyndN0nkfyzS31E05tZi61RfXQ2UPY2_5ceKYua5U6d5Zd</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <adr_address>&lt;span class=&quot;street-address&quot;&gt;48 Pirrama Rd&lt;/span&gt;, &lt;span class=&quot;locality&quot;&gt;Pyrmont&lt;/span&gt; &lt;span class=&quot;region&quot;&gt;NSW&lt;/span&gt; &lt;span class=&quot;postal-code&quot;&gt;2009&lt;/span&gt;, &lt;span class=&quot;country-name&quot;&gt;Australia&lt;/span&gt;</adr_address>
  <user_ratings_total>939</user_ratings_total>
  <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id>
  <plus_code>
   <global_code>4RRH45MW+C8</global_code>
   <compound_code>45MW+C8 Pyrmont NSW, Australia</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceDetailsResponse>

JSON ve XML yanıtları aşağıdaki öğeleri içerir:

PlacesDetailsResponse

Alan Zorunlu Tür Açıklama
required Array<string>

Bu girişle ilgili, kullanıcıya gösterilmesi gereken bir dizi ilişkilendirme içerebilir (bazı girişlerde ilişkilendirme olmayabilir).

required Place

İstenen yerle ilgili ayrıntılı bilgileri içerir.

Daha fazla bilgi için Yer'i inceleyin.
required PlacesDetailsStatus

İsteğin durumunu içerir ve isteğin neden başarısız olduğunu bulmanıza yardımcı olacak hata ayıklama bilgileri içerebilir.

Daha fazla bilgi için PlacesDetailsStatus bölümünü inceleyin.

isteğe bağlı Array<string>

Hizmet, istek spesifikasyonu hakkında ek bilgiler döndürdüğünde yanıt nesnesinde ek bir info_messages alanı olabilir. Bu alan yalnızca başarılı istekler için döndürülür. Bu sonuç her zaman döndürülmeyebilir ve içeriği değişebilir.

Bunlar, JSON yanıtında kök öğeler olarak gösterilir. Bunlar, bir XML yanıtında <PlaceDetailsResponse> altında üst düzey öğeler olarak görünür.

PlacesDetailsStatus

Hizmet tarafından döndürülen durum kodları.

  • OK, API isteğinin başarılı olduğunu gösterir.
  • ZERO_RESULTS, başvurulan konumun (place_id) geçerli olduğunu ancak artık geçerli bir sonucu ifade etmediğini gösterir. Bu durum, işletmenin artık faaliyet göstermemesi nedeniyle oluşabilir.
  • NOT_FOUND, başvuruda bulunulan konumun (place_id) Yerler veritabanında bulunamadığını gösteriyor.
  • INVALID_REQUEST, API isteğinin hatalı biçimlendirildiğini gösterir.
  • OVER_QUERY_LIMIT aşağıdakilerden herhangi birini gösteriyorsa:
    • Saniyedeki sorgu sınırlarını aştınız.
    • Hesabınızda faturalandırma etkinleştirilmemiştir.
    • Aylık 200 ABD doları kredi veya kendinizin belirlediği kullanım sınırı aşılmıştır.
    • Belirtilen ödeme yöntemi artık geçerli değil (ör. kredi kartının süresi dolmuş).
    Bu hatayı nasıl gidereceğiniz hakkında daha fazla bilgi için Haritalar SSS bölümüne bakın.
  • REQUEST_DENIED. Bu e-postada, isteğinizin reddedildiği belirtilir. Bunun nedeni genellikle:
    • İstek API anahtarı içermiyor.
    • key parametresi geçersiz.
  • UNKNOWN_ERROR bilinmeyen bir hatayı gösterir.

Yer

Bir yeri tanımlayan özellikler. Tüm özellikler tüm yer türlerinde kullanılamaz.

Alan Zorunlu Tür Açıklama
isteğe bağlı Array<AddressComponent>

Bu adres için geçerli olan ayrı bileşenleri içeren bir dizi.

Daha fazla bilgi için AddressComponent sayfasına göz atın.

isteğe bağlı dize

Yer adresinin adr mikro biçimindeki gösterimi.

isteğe bağlı dize

İşletme ise yerin operasyonel durumunu gösterir. Veri yoksa business_status döndürülmez.

The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
isteğe bağlı boolean

İşletmenin arabaya teslim alma hizmetini destekleyip desteklemediğini belirtir.
isteğe bağlı PlaceOpeningHours

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

Daha fazla bilgi için PlaceOpeningHours'u inceleyin.

isteğe bağlı boolean

İşletmenin teslimatı destekleyip desteklemediğini belirtir.
isteğe bağlı boolean

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

isteğe bağlı PlaceEditorialSummary

Yerin özetini içerir. Özet, metin biçiminde bir genel bakıştan oluşur ve geçerli durumlarda bu metinlerin dil kodunu da içerir. Özet metni olduğu gibi sunulmalı, değiştirilmemeli veya üzerinde oynanmamalıdır.

Daha fazla bilgi için PlaceEditorialSummary bölümüne bakın.

isteğe bağlı dize

Bu yerin okunabilir adresini içeren bir dize.

Bu adres genellikle posta adresine eşdeğerdir. Birleşik Krallık gibi bazı ülkelerde lisanslama kısıtlamaları nedeniyle gerçek posta adreslerinin dağıtımına izin verilmediğini unutmayın.

Biçimlendirilmiş adres, mantıksal olarak bir veya daha fazla adres bileşeninden oluşur. Örneğin, "111 8th Avenue, New York, NY" adresi şu bileşenlerden oluşur: "111" (sokak numarası), "8th Avenue" (yol), "New York" (şehir) ve "NY" (ABD eyaleti).

Biçimlendirilmiş adresi programatik olarak ayrıştırmayın. Bunun yerine, API yanıtının biçimlendirilmiş adres alanına ek olarak içerdiği bağımsız adres bileşenlerini kullanmanız gerekir.

isteğe bağlı dize

İşletmenin telefon numarasını yerel biçimde içerir.

isteğe bağlı Geometry

Konumun yerini ve görünüm alanını içerir.

Daha fazla bilgi için Geometry sayfasına göz atın.
isteğe bağlı dize

Bu sonucu haritada belirtirken kullanıcıya gösterilebilecek önerilen simgenin URL'sini içerir.

isteğe bağlı dize

Yer kategorisinin varsayılan onaltılık renk kodunu içerir.
isteğe bağlı dize

.svg veya .png dosya türü uzantısı hariç olmak üzere, önerilen bir simgenin URL'sini içerir.

isteğe bağlı dize

İşletmenin uluslararası standarda uygun telefon numarasını içerir. Uluslararası standartta ülke kodu bulunur ve numaranın başına artı (+) işareti eklenir. Örneğin, Google'ın Sidney, Avustralya ofisinin international_phone_number değeri +61 2 9374 4000'dır.

isteğe bağlı dize

Döndürülen sonucun kullanıcılar tarafından okunabilen adını içerir. establishment sonuçlarında bu genellikle kurallı işletme adıdır.

isteğe bağlı PlaceOpeningHours

Normal çalışma saatlerini içerir.

Daha fazla bilgi için PlaceOpeningHours'u inceleyin.

isteğe bağlı boolean

İşletmelerin operasyonel durumunu öğrenmek için business_status kullanın.

isteğe bağlı Array<PlacePhoto>

Her biri bir resme referans içeren fotoğraf nesneleri dizisi. Bir istek en fazla on fotoğraf döndürebilir. Yer fotoğrafları ve bu resimleri uygulamanızda nasıl kullanabileceğiniz hakkında daha fazla bilgiyi Yer Fotoğrafları dokümanında bulabilirsiniz.

Daha fazla bilgi için PlacePhoto bölümüne bakın.
isteğe bağlı dize

Bir yeri benzersiz şekilde tanımlayan metin tanımlayıcısı. Yerle ilgili bilgileri almak için bu tanımlayıcıyı bir Places API isteğinin place_id alanına iletin. Yer kimlikleri hakkında daha fazla bilgi için Yer kimliği genel bakışı başlıklı makaleyi inceleyin.

isteğe bağlı PlusCode

Enlem ve boylam koordinatlarından elde edilen, kodlanmış bir konum referansı. Bir alanı temsil eder: 1/8000 dereceye 1/8000 derece (Ekvator'da yaklaşık 14 m x 14 m) veya daha küçük. Plus code'lar, sokak adreslerinin olmadığı yerlerde (binaların numaralandırılmadığı veya sokakların adlandırılmadığı yerler) sokak adreslerinin yerine kullanılabilir. Open Location Code ve plus kodları başlıklı makalelere göz atın.

Daha fazla bilgi için PlusCode sayfasına göz atın.
isteğe bağlı sayı

Yerin fiyat düzeyi (0-4 ölçeğinde). Belirli bir değerle belirtilen tam tutar bölgeden bölgeye değişir. Fiyat seviyeleri aşağıdaki gibi yorumlanır:

  • 0 Ücretsiz
  • 1 Uygun fiyatlı
  • 2 Orta
  • 3 Pahalı
  • 4 Çok Pahalı
isteğe bağlı sayı

Toplanan kullanıcı yorumlarına göre yerin 1, 0 ile 5, 0 arasındaki puanını içerir.

isteğe bağlı dize
isteğe bağlı boolean

Mekanın rezervasyonları destekleyip desteklemediğini belirtir.
isteğe bağlı Array<PlaceReview>

En fazla beş yorum içeren bir JSON dizisi. Yorumlar varsayılan olarak alaka düzeyine göre sıralanır. Sıralamayı kontrol etmek için reviews_sort istek parametresini kullanın.

  • most_relevant (varsayılan) için yorumlar alaka düzeyine göre sıralanır. Hizmet, sonuçları tercih edilen dilde yazılmış yorumları döndürecek şekilde yönlendirir.
  • newest için yorumlar kronolojik sıraya göre sıralanır. Tercih edilen dil, sıralama düzenini etkilemez.

Google, kullanıcılara sonuçların most_relevant veya newest'ye göre sıralanıp sıralanmadığını belirtmenizi önerir.

Daha fazla bilgi için PlaceReview sayfasına göz atın.

isteğe bağlı dize
isteğe bağlı Array<PlaceOpeningHours>

İş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 temel çalışma saatlerinden farklıdır. Örneğin, bir restoran, ikinci çalışma saatleri olarak arabaya servis saatlerini veya teslimat saatlerini belirtebilir. Bu alan, yer türlerine göre çalışma saatleri türlerinin (ör. DRIVE_THROUGH, PICKUP veya TAKEOUT) önceden tanımlanmış bir listesinden alınan type alt alanını doldurur. Bu alan, özel çalışma saatleri olan tarihler için ayarlanan tüm saatlerin special_days alt alanını içerir.

Daha fazla bilgi için PlaceOpeningHours'u inceleyin.

isteğe bağlı boolean

Mekanda bira servisi yapılıp yapılmadığını belirtir.
isteğe bağlı boolean

Mekanda kahvaltı servisi olup olmadığını belirtir.
isteğe bağlı boolean

Mekanda geç kahvaltı servisi yapılıp yapılmadığını belirtir.
isteğe bağlı boolean

Mekanda akşam yemeği servisi yapılıp yapılmadığını belirtir.
isteğe bağlı boolean

Mekanda öğle yemeği servisi yapılıp yapılmadığını belirtir.
isteğe bağlı boolean

Mekanda vejetaryen yemekler servis edilip edilmediğini belirtir.
isteğe bağlı boolean

Mekanda şarap servisi olup olmadığını belirtir.
isteğe bağlı boolean

İşletmenin paket servisi seçeneğini destekleyip desteklemediğini belirtir.
isteğe bağlı Array<string>

Belirli bir sonucu açıklayan özellik türlerinin dizisini içerir. Desteklenen türlerin listesine bakın.

isteğe bağlı dize

Bu yerin resmi Google sayfasının URL'sini içerir. Bu, yerle ilgili mevcut en iyi bilgileri içeren ve Google'a ait olan sayfadır. Uygulamalar, kullanıcıya yerle ilgili ayrıntılı sonuçları gösteren tüm ekranlarda bu sayfaya bağlantı vermelidir veya bu sayfayı yerleştirmelidir.

isteğe bağlı sayı

Bu yerle ilgili toplam yorum sayısı (metin içeren veya içermeyen).

isteğe bağlı sayı

Bu yerin geçerli saat diliminin UTC'den kaç dakika farklı olduğunu gösterir. Örneğin, Avustralya'nın Sidney şehrinde yaz saati uygulaması sırasında bu değer 660 (+UTC'den 11 saat) olurken Kaliforniya'da yaz saati uygulaması dışında bu değer -480 (-UTC'den 8 saat) olur.

isteğe bağlı dize

Yalnızca kuruluş (types:["establishment", ...]) sonuçları için vicinity alanı, yerin sokak adı, sokak numarası ve yerleşim yeri gibi basitleştirilmiş bir adresini içerir ancak il/eyalet, posta kodu veya ülke bilgilerini içermez.

Diğer tüm sonuçlarda, vicinity alanı, sonucun adresinde bulunan en dar siyasi (types:["political", ...]) özelliğin adını içerir.

Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adres programatik olarak ayrıştırılmamalıdır.

isteğe bağlı dize

Bu yerin yetkili web sitesi (ör. bir işletmenin ana sayfası).

isteğe bağlı boolean

Yerlerde tekerlekli sandalye kullanıcılarına uygun giriş olup olmadığını belirtir.

PlaceEditorialSummary

Yerin özetini içerir. Özet, metin biçiminde bir genel bakıştan oluşur ve geçerli durumlarda bu öğelerin dil kodunu da içerir. Özet metni olduğu gibi sunulmalı, değiştirilmemeli veya üzerinde oynanmamalıdır.

Alan Zorunlu Tür Açıklama
isteğe bağlı dize

Önceki alanların dili. Her zaman mevcut olmayabilir.
isteğe bağlı dize

Yerin orta uzunlukta metin özeti.

PlaceOpeningHours

Bir yerin çalışma saatlerini açıklayan nesne.

Alan Zorunlu Tür Açıklama
isteğe bağlı boolean

Yerin şu anda açık olup olmadığını gösteren bir boole değeri.

isteğe bağlı Array<PlaceOpeningHoursPeriod>

Pazar gününden başlayarak yedi günü kapsayan, kronolojik sıraya göre düzenlenmiş bir açılış dönemleri dizisi.

Daha fazla bilgi için PlaceOpeningHoursPeriod'a bakın.

isteğe bağlı Array<PlaceSpecialDay>

Önümüzdeki yedi güne karşılık gelen en fazla yedi girişten oluşan bir dizi.

Daha fazla bilgi için PlaceSpecialDay sayfasına bakın.

isteğe bağlı dize

İkincil saatlerin türünü tanımlamak için kullanılan bir tür dizesi (örneğin, DRIVE_THROUGH, HAPPY_HOUR, DELIVERY, TAKEOUT, KITCHEN, BREAKFAST, LUNCH, DINNER, BRUNCH, PICKUP, SENIOR_HOURS). Yalnızca secondary_opening_hours için ayarlanır.

weekday_text

isteğe bağlı Array<string>

Yerin çalışma saatlerini kullanıcıların okuyabileceği metinle açıklayan bir dizeler dizisi.

PlaceOpeningHoursPeriod

Alan Zorunlu Tür Açıklama
required PlaceOpeningHoursPeriodDetail

Yerin açılış saatini açıklayan bir gün ve saat nesnesi çifti içerir.

Daha fazla bilgi için PlaceOpeningHoursPeriodDetail bölümüne bakın.

isteğe bağlı PlaceOpeningHoursPeriodDetail

Mekanın kapanış zamanını açıklayan bir gün ve saat nesnesi çifti içerebilir. Bir yer her zaman açıksa yanıtta kapanış bölümü yer almaz. Müşteriler, 7/24 açık olma durumunun 0 değerine sahip gün ve 0000 değerine sahip zaman içeren, close içermeyen bir açık dönem olarak gösterilmesine güvenebilir.

Daha fazla bilgi için PlaceOpeningHoursPeriodDetail bölümüne bakın.

PlaceSpecialDay

Alan Zorunlu Tür Açıklama
isteğe bağlı dize

Yerel saat diliminde RFC3339 biçiminde ifade edilen bir tarih (ör. 2010-12-31).

isteğe bağlı boolean

Bu gün için özel çalışma saatleri varsa doğru. true ise bu gün için en az bir istisna olduğu anlamına gelir. İstisnalar, current_opening_hours ve secondary_opening_hours alt alanlarında periods, weekday_text, open_now gibi farklı değerlerin oluşmasına neden olur. İstisnalar saatler için geçerlidir ve saatler diğer alanları oluşturmak için kullanılır.

PlaceOpeningHoursPeriodDetail

Alan Zorunlu Tür Açıklama
required sayı

Pazar gününden başlayarak haftanın günlerine karşılık gelen 0-6 arasındaki bir sayı. Örneğin, 2 sayısı Salı gününü ifade eder.

required dize

24 saatlik ssdd biçiminde günün saatini içerebilir. Değerler 0000-2359 aralığındadır. Zaman, yerin saat diliminde bildirilir.

isteğe bağlı dize

Yerel saat diliminde RFC3339 biçiminde ifade edilen bir tarih (ör. 2010-12-31).

isteğe bağlı boolean

Belirli bir dönem, yedi günlük kesme nedeniyle kısaltıldıysa doğru değerini döndürür. Bu durumda dönem, istek tarihinin gece yarısından önce başlar ve/veya son günün gece yarısında ya da sonrasında sona erer. Bu özellik, açık veya kapalı olma süresinin bu yedi günlük sınırdan sonra da devam edebileceğini gösterir.

PlacePhoto

Bir yerin fotoğrafı. Fotoğrafa, aşağıdaki desende bir URL kullanılarak Place Photo API ile erişilebilir: 

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY

Daha fazla bilgi için Yer Fotoğrafları başlıklı makaleyi inceleyin.

Alan Zorunlu Tür Açıklama
required sayı

Fotoğrafın yüksekliği.
required Array<string>

Fotoğrafın HTML atıfları.
required dize

Fotoğraf isteği gerçekleştirdiğinizde fotoğrafı tanımlamak için kullanılan dize.

required sayı

Fotoğrafın genişliği.

PlaceReview

Kullanıcı tarafından gönderilen yer yorumu.

Alan Zorunlu Tür Açıklama
required dize

Yorumu gönderen kullanıcının adı. Anonim yorumlar "Bir Google kullanıcısı" olarak ilişkilendirilir.

required sayı

Kullanıcının bu yer için verdiği genel puan. Bu, 1 ile 5 arasında değişen bir tam sayıdır.

required dize

Yorumun metin olarak gönderildiği zaman, geçerli zamana göre.

required sayı

Yorumun gönderildiği zaman, 1 Ocak 1970 UTC tarihinden bu yana geçen saniye sayısı olarak ölçülür.

isteğe bağlı dize

Kullanıcının Google Haritalar Yerel Rehberler profilinin URL'si (varsa).

isteğe bağlı dize

Döndürülen yorumun dilini belirten bir IETF dil kodu.Bu alan yalnızca ana dil etiketini içerir ve ülke veya bölgeyi belirten ikincil etiketi içermez. Örneğin, tüm İngilizce yorumlar "en-AU" veya "en-UK" gibi değil, "en" olarak etiketlenir.Yalnızca puan verilmiş ancak yorum metni içermeyen durumlarda bu alan boştur.

isteğe bağlı dize

Yorumun orijinal dilini belirten bir IETF dil kodu. Yorum çevrilmişse original_language != language. Bu alan yalnızca ana dil etiketini içerir. Ülkeyi veya bölgeyi belirten ikincil etiket bu alanda yer almaz. Örneğin, tüm İngilizce yorumlar "en" olarak etiketlenir, "en-AU" veya "en-UK" olarak etiketlenmez.Yalnızca puan verilmişse ve yorum metni yoksa bu alan boştur.

isteğe bağlı dize

Kullanıcının profil fotoğrafının URL'si (varsa).

text

isteğe bağlı dize

Kullanıcının yorumu. Google Yerler ile bir konumu incelerken metin yorumları isteğe bağlı olarak değerlendirilir. Bu nedenle, bu alan boş olabilir. Bu alanın temel HTML biçimlendirmesi içerebileceğini unutmayın. Örneğin, &amp; öğe referansı, ve işareti karakterini temsil edebilir.

isteğe bağlı boolean

Yorumun, yazıldığı orijinal dilden çevrilip çevrilmediğini belirten bir Boole değeri.Bir yorum çevrilmişse (true değerine karşılık gelir) Google, bunu kullanıcılarınıza belirtmenizi önerir. Örneğin, yoruma "Google tarafından çevrildi" dizesini ekleyebilirsiniz.