Yer Ayrıntıları (eski)

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Yer Arama'dan 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 Nesnesi Gösterimi (JSON) biçiminde çıkışı 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 verilmiştir.

Gerekli parametreler

  • place_id

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

İsteğe bağlı parametreler

  • Fields

    Dikkat: Yer Arama (Eski) istekleri ve Yer Ayrıntıları (Eski) istekleri aynı alanları döndürmez. Yer Arama (Eski) istekleri, Yer Ayrıntıları (Eski) istekleri tarafından döndürülen alanların bir alt kümesini döndürür. İstediğiniz alan Yer Arama (Eski) tarafından döndürülmüyorsa place_id almak için Yer Arama'yı (Eski) kullanabilir, ardından Yer Ayrıntıları (Eski) isteğinde bulunmak için bu yer kimliğini kullanabilirsiniz. Yer Arama (Eski) isteğinde kullanılamayan alanlar hakkında daha fazla bilgi için Yer Veri Alanları (Eski) 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, İlgili 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 Metinle 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 (kullanımdan kaldırıldı), 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ın istenip istenmediğine bakılmaksızın, her çağrıda html_attributions ilişkilendirmeleri her zaman 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ğinden bu liste kapsamlı olmayabilir.
    • language sağlanmazsa API, Accept-Language başlığında belirtilen tercih edilen dili kullanmaya çalışır.
    • API, hem kullanıcı hem de yerel halk için okunabilir bir açık adres sağlamak üzere 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 sokak adreslerini 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.
    • Ad, tercih edilen dilde mevcut değilse 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ı şekilde 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ısıdır.
  • bölge

    Bölge kodu, ccTLD ("üst düzey alan") olarak belirtilen 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 atlanı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ı (Eski) için bir çağrı 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ında oturum jetonlarını kullanın.
    • Her oturum için yeni bir jeton oluşturun. 4. sürüm UUID kullanılması ö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. Aynı jetonun birden fazla oturum için kullanılması, her isteğin ayrı ayrı faturalandırılmasına neden olur.

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

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

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 Dizi<dize>

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 sayfasına bakın.

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'a bakın.

isteğe bağlı Dizi<dize>

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 yanıt 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, referans verilen 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 halinde ortaya çıkabilir.
  • 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:
    • Saniyede sorgu sınırlarını aştınız.
    • Hesabınızda faturalandırma etkinleştirilmemiştir.
    • Aylık 200 ABD doları tutarındaki kredi veya kendinizin belirlediği kullanım sınırı aşılmıştır.
    • Belirtilen ödeme yöntemi artık geçerli değil (örneğin, kredi kartının süresi dolmuş).
    Bu hatayı nasıl düzelteceğiniz hakkında daha fazla bilgi için Haritalar SSS sayfasını inceleyin.
  • REQUEST_DENIED isteğinizin reddedildiğini belirtir. Genellikle şu nedenlerle:
    • İstek API anahtarı içermiyor.
    • key parametresi geçersiz.
  • UNKNOWN_ERROR bilinmeyen bir hata olduğunu 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ı Dizi<AddressComponent>

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

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

isteğe bağlı dize

Yerin 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ı boole

İş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 tarihinin 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 sayfasına bakın.

isteğe bağlı boole

İşletmenin teslimatı destekleyip desteklemediğini belirtir.

isteğe bağlı boole

İş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 dillerin dil kodunu da içerir. Özet metin olduğu gibi sunulmalı, değiştirilemez veya üzerinde oynanamaz.

Daha fazla bilgi için PlaceEditorialSummary sayfasına 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" (rota), "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

Yerin telefon numarasını yerel biçimde içerir.

isteğe bağlı Geometry

Konum ve konumun 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

Haritada bu sonucu 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ç, önerilen bir simgenin URL'sini içerir.

isteğe bağlı dize

İşletmenin uluslararası standarttaki telefon numarasını içerir. Uluslararası standart, ülke kodunu içerir ve artı (+) işaretiyle başlar. Örneğin, Google'ın Sidney, Avustralya ofisinin international_phone_number'ı +61 2 9374 4000.

isteğe bağlı dize

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

isteğe bağlı PlaceOpeningHours

Normal çalışma saatlerini içerir.

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

isteğe bağlı boole

İş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 istekte en fazla on fotoğraf döndürülebilir. Yer fotoğrafları ve uygulamalarınızda bu görüntüleri nasıl kullanabileceğiniz hakkında daha fazla bilgiyi Yer Fotoğrafları dokümanında bulabilirsiniz.

Daha fazla bilgi için PlacePhoto sayfasına göz atı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

Bir alanı temsil eden, enlem ve boylam koordinatlarından elde edilen kodlanmış bir konum referansı: 1/8000 dereceye 1/8000 derece (Ekvator'da yaklaşık 14 m x 14 m) veya daha küçük. Artı kodları, 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 Code 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ı

Mekanın 0 ile 4 arasındaki fiyat düzeyi. Belirli bir değerle gösterilen tam tutar bölgeden bölgeye değişir. Fiyat seviyeleri aşağıdaki şekilde yorumlanır:

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

Toplu 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ı boole

Mekanın rezervasyonları destekleyip desteklemediğini belirtir.

isteğe bağlı Dizi<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 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ı Dizi<PlaceOpeningHours>

Bir işletmenin ikincil çalışma saatleriyle ilgili 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, arabaya servis saatlerini veya teslimat saatlerini ikincil çalışma saatleri olarak 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 sayfasına bakın.

isteğe bağlı boole

Mekanda bira servisi olup olmadığını belirtir.

isteğe bağlı boole

Mekanda kahvaltı servisi olup olmadığını belirtir.

isteğe bağlı boole

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

isteğe bağlı boole

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

isteğe bağlı boole

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

isteğe bağlı boole

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

isteğe bağlı boole

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

isteğe bağlı boole

İşletmenin paket servisi destekleyip desteklemediğini belirtir.

isteğe bağlı Dizi<dize>

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 bir sayfa olur. 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 metin içeren veya içermeyen toplam yorum sayısı.

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 sonra), Kaliforniya'da yaz saati uygulaması dışında ise -480 (UTC'den 8 saat önce) olur.

isteğe bağlı dize

İşletme (types:["establishment", ...]) sonuçları için vicinity alanı, yerin basitleştirilmiş adresini içerir. Bu adreste sokak adı, sokak numarası ve yerleşim yeri bulunur ancak il/eyalet, posta kodu veya ülke bilgisi yer almaz.

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. işletmenin ana sayfası).

isteğe bağlı boole

Yer tekerlekli sandalye kullanıcılarına uygun bir girişe sahipse bunu 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 metin 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ı boole

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 açılış dönemlerinin kronolojik sıraya göre dizilmiş bir dizisi.

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

isteğe bağlı Dizi<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 göz atı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.

isteğe bağlı Dizi<dize>

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 ne zaman açıldığını açıklayan bir gün ve saat nesnesi çifti içerir.

Daha fazla bilgi için PlaceOpeningHoursPeriodDetail sayfasını inceleyin.

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, her zaman açık olan işletmelerin 0 değerine sahip gün ve 0000 değerine sahip saat içeren bir açık dönem olarak gösterileceğine ve close değerinin olmayacağına güvenebilir.

Daha fazla bilgi için PlaceOpeningHoursPeriodDetail sayfasını inceleyin.

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ı boole

Bu gün için özel çalışma saatleri varsa doğru değerini döndürür. 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ı

Haftanın günlerine karşılık gelen ve pazar günüyle başlayan 0-6 arasındaki bir sayı. Örneğin, 2 sayısı Salı anlamına gelir.

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ı boole

Belirli bir dönem, yedi günlük kesme nedeniyle kısaltılmışsa doğru değerini döndürür. Bu durumda dönem, istek tarihinde gece yarısından önce başlar ve/veya son günde gece yarısı ya da sonrasında sona erer. Bu özellik, açık veya kapalı kalma süresinin yedi günlük son tarihi aşabileceğini gösterir.

PlacePhoto

Bir yerin fotoğrafı. Fotoğrafa, aşağıdaki kalıpta bir URL kullanılarak Yer Fotoğrafı API'si 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 Dizi<dize>

Fotoğrafın HTML atıfları.

required dize

Fotoğraf isteği gönderdiğinizde fotoğrafı tanımlamak için kullanılan dize.

required sayı

Fotoğrafın genişliği.

PlaceReview

Bir 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ı"na atfedilir.

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 gönderildiği zamanın, mevcut zamana göre metin olarak belirtilmiş hali.

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şse ve yorum metni yoksa 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, ülke veya bölgeyi belirten ikincil etiketi içermez. Örneğin, tüm İngilizce yorumlar "en" olarak etiketlenir, "en-AU" veya "en-UK" olarak etiketlenmez.Yalnızca puan varsa 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).

isteğe bağlı dize

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

isteğe bağlı boole

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.