جزئیات جا (قدیمی)

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

وقتی place_id را از جستجوی مکان دریافت کردید، می‌توانید با شروع درخواست «جزئیات مکان» (قدیمی)، جزئیات بیشتری درباره مؤسسه یا نقطه موردنظر درخواست کنید. درخواست «جزئیات مکان» (قدیمی) اطلاعات جامع‌تری درباره مکان نشان‌داده‌شده برمی‌گرداند مثل آدرس کامل، شماره تلفن، رده‌بندی کاربر، و مرورها.

درخواست‌های «جزئیات جا» (قدیمی)

درخواست «جزئیات مکان (قدیمی)» یک نشانی وب HTTP به‌شکل زیر است:

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

که در آن output می‌تواند یکی از مقادیر زیر باشد:

  • json (توصیه می‌شود) نشان‌دهنده برونداد در «نشان‌گذاری شیء جاوا اسکریپت» (JSON) است
  • xml نشان‌دهنده برونداد به‌عنوان XML است

برای شروع درخواست جستجو، پارامترهای خاصی لازم است. همان‌طور که در نشانی‌های وب استاندارد است، همه پارامترها بااستفاده از نویسه اَمپرسند (&) از هم جدا می‌شوند. در زیر فهرستی از پارامترها و مقادیر ممکن آن‌ها آمده است.

پارامترهای الزامی

پارامترهای اختیاری

  • فیلدها

    احتیاط: درخواست‌های «جستجوی مکان» (قدیمی) و درخواست‌های «جزئیات مکان» (قدیمی) فیلدهای یکسانی برنمی‌گردانند. درخواست‌های «جستجوی مکان» (قدیمی) زیرمجموعه‌ای از فیلدهایی را برمی‌گرداند که درخواست‌های «جزئیات مکان» (قدیمی) برمی‌گرداند. اگر فیلد موردنظرتان توسط «جستجوی مکان» (قدیمی) برگردانده نشد، می‌توانید از «جستجوی مکان» (قدیمی) برای دریافت place_id استفاده کنید، سپس از آن «شناسه مکان» برای درخواست «جزئیات مکان» (قدیمی) استفاده کنید. برای اطلاعات بیشتر درباره فیلدهایی که در درخواست «جستجوی مکان» (قدیمی) دردسترس نیست، فیلدهای داده مکان (قدیمی) را ببینید.

    از پارامتر فیلدها برای مشخص کردن فهرست جداشده با کاما از انواع داده‌های مکان برای برگرداندن استفاده کنید. برای مثال: fields=formatted_address,name,geometry. هنگام مشخص کردن مقادیر مرکب، از خط مورب استفاده کنید. برای مثال: opening_hours/open_now.

    فیلدها به سه دسته صورت‌حساب تقسیم می‌شوند: پایه، تماس، و فضاسازی. «واحد نگهداری انبار» (SKU) «پایه»، «تماس»، و «جو» علاوه‌بر «واحد نگهداری انبار» پایه (Places Details،‏ Find Place،‏ Nearby Search، یا Text Search) برای درخواستی که آن‌ها را راه‌اندازی کرده است کسر هزینه می‌شود. برای اطلاعات بیشتر، برگ قیمت را ببینید.

    پایه

    دسته «پایه» شامل فیلدهای زیر است: address_components، adr_address، business_status، formatted_address، geometry، icon، icon_mask_base_uri، icon_background_color، name، permanently_closed (منسوخ‌شده)، photo، place_id، plus_code، type، url، utc_offset، vicinity، wheelchair_accessible_entrance.

    تماس

    دسته «مخاطب» شامل فیلدهای زیر است: current_opening_hours، formatted_phone_number، international_phone_number، opening_hours، secondary_opening_hours، website

    محیط

    دسته «جو» شامل فیلدهای زیر است: 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.

    توجه: ارجاع‌ها، html_attributions، همیشه با هر تماس برگردانده می‌شوند، صرف‌نظر از اینکه فیلد درخواست شده باشد یا نه.
  • زبان

    زبانی که نتایج به آن برگردانده می‌شود.

    • فهرست زبان‌های پشتیبانی‌شده را ببینید. ‫Google اغلب زبان‌های پشتیبانی‌شده را به‌روز می‌کند، بنابراین این فهرست ممکن است کامل نباشد.
    • اگر language ارائه نشده باشد، API تلاش می‌کند از زبان ترجیحی مشخص‌شده در سرصفحه Accept-Language استفاده کند.
    • این API تلاش می‌کند نشانی خیابانی ارائه دهد که هم برای کاربر و هم برای افراد محلی خوانا باشد. برای رسیدن به این هدف، نشانی‌های خیابان را به زبان محلی برمی‌گرداند و درصورت لزوم، با رعایت زبان ترجیحی کاربر، آن را به خطی که کاربر بتواند بخواند آوانویسی می‌کند. همه نشانی‌های دیگر به زبان ترجیحی برگردانده می‌شوند. اجزای نشانی همه به یک زبان برگردانده می‌شوند که از اولین جزء انتخاب می‌شود.
    • اگر نامی به زبان ترجیحی دردسترس نباشد، API از نزدیک‌ترین مطابقت استفاده می‌کند.
    • زبان ترجیحی تأثیر کمی بر مجموعه نتایجی دارد که «میانای برنامه‌سازی کاربردی» برای برگرداندن انتخاب می‌کند و ترتیبی که برگردانده می‌شوند. کدبند براساس زبان، مخفف‌ها را به‌شکل متفاوتی تفسیر می‌کند، برای مثال، مخفف‌های انواع خیابان، یا مترادف‌هایی که ممکن است در یک زبان معتبر باشند اما در زبان دیگر معتبر نباشند. برای مثال، utca و tér مترادف خیابان در زبان مجارستانی هستند.
  • منطقه

    کد منطقه، که به‌عنوان ccTLD ("دامنه سطح بالا") مقدار دو نویسه‌ای مشخص شده است. اکثر کدهای ccTLD با کدهای ISO 3166-1 یکسان هستند، با چند استثنای قابل‌توجه. برای مثال، ccTLD پادشاهی متحد «uk» (.co.uk) است، درحالی‌که کد ISO 3166-1 آن «gb» است (ازنظر فنی برای نهاد «پادشاهی متحد بریتانیای کبیر و ایرلند شمالی»).

  • reviews_no_translations

    برای غیرفعال کردن ترجمه مرورها، reviews_no_translations=true را مشخص کنید؛ برای فعال کردن ترجمه مرورها، reviews_no_translations=false را مشخص کنید. مرورها به زبان اصلی‌شان برگردانده می‌شوند.

    اگر حذف شود یا بدون مقدار ارسال شود، ترجمه مرورها فعال می‌شود. اگر پارامتر language در درخواست مشخص شده باشد، از زبان مشخص‌شده به‌عنوان زبان ترجیحی برای ترجمه استفاده کنید. اگر language حذف شود، میانای برنامه‌سازی کاربردی تلاش می‌کند از سرصفحه Accept-Language به‌عنوان زبان برگزیده استفاده کند.

  • reviews_sort

    روش مرتب‌سازی که هنگام برگرداندن مرورها استفاده می‌شود. می‌تواند روی most_relevant (پیش‌فرض) یا newest تنظیم شود.

    • برای most_relevant (پیش‌فرض)، مرورها براساس میزان مربوط بودن مرتب می‌شوند؛ این سرویس نتایج را به‌گونه‌ای سوگیری می‌کند که مرورهایی را که دراصل به زبان ترجیحی نوشته شده‌اند برگرداند.
    • برای newest، مرورها به‌ترتیب زمانی مرتب شده‌اند؛ زبان ترجیحی بر ترتیب مرتب‌سازی تأثیری ندارد.

    ‫Google توصیه می‌کند نحوه مرتب‌سازی مرورها را به کاربر نهایی نمایش دهید.

  • sessiontoken

    رشته‌ای تصادفی که جلسه تکمیل خودکار را برای اهداف صورت‌حساب شناسایی می‌کند.

    جلسه زمانی شروع می‌شود که کاربر شروع به تایپ کردن پُرسمان می‌کند و زمانی به‌پایان می‌رسد که کاربر مکانی را انتخاب می‌کند و تماسی با «جزئیات مکان (قدیمی)» برقرار می‌شود. هر جلسه می‌تواند چند پُرسمان داشته باشد و پس‌از آن یک مکان انتخاب شود. کلید(های) میانای برنامه‌سازی کاربردی استفاده‌شده برای هر درخواست در یک جلسه باید به همان پروژه کنسول Google Cloud تعلق داشته باشد. پس‌از پایان جلسه، کد دیگر معتبر نیست؛ برنامه شما باید برای هر جلسه کد جدیدی تولید کند. اگر پارامتر sessiontoken حذف شود، یا اگر از نشانه جلسه مجدداً استفاده کنید، هزینه جلسه به‌گونه‌ای محاسبه می‌شود که انگار نشانه جلسه ارائه نشده است (هزینه هر درخواست به‌طور جداگانه محاسبه می‌شود).

    رهنمودهای زیر را توصیه می‌کنیم:

    • از کد جلسه برای همه جلسه‌های تکمیل خودکار استفاده کنید.
    • برای هر جلسه، کد جدیدی تولید کنید. استفاده از نسخه ۴ UUID توصیه می‌شود.
    • مطمئن شوید کلید(های) API مورداستفاده برای همه درخواست‌های «تکمیل خودکار مکان» و «جزئیات مکان» در یک جلسه به یک پروژه Cloud Console تعلق داشته باشد.
    • حتماً برای هر جلسه جدید، کد جلسه یکتایی ارسال کنید. استفاده از یک توکن برای بیش‌از یک جلسه باعث می‌شود که هر درخواست به‌صورت جداگانه صورت‌حساب شود.

نمونه «جزئیات جا» (قدیمی)

مثال زیر جزئیات مکان را براساس place_id درخواست می‌کند و شامل فیلدهای name، rating، و formatted_phone_number می‌شود:

صدف

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

توجه داشته باشید که برای اینکه درخواست در برنامه‌تان کار کند، باید کلید موجود در این مثال را با کلید میانای برنامه‌سازی کاربردی خودتان جایگزین کنید.

پاسخ «جزئیات جا» (قدیمی)

پاسخ‌های «جزئیات مکان (قدیمی)» در قالبی که با پرچم output در مسیر نشانی وب درخواست مشخص شده است برگردانده می‌شود.

(قالب) 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 و XML هرکدام شامل عناصر زیر هستند:

PlacesDetailsResponse

فیلد الزامی نوع شرح
الزامی آرایه<رشته>

ممکن است حاوی مجموعه‌ای از اسناد این فهرستگان باشد که باید به کاربر نمایش داده شود (برخی‌از فهرستگان‌ها ممکن است سند نداشته باشند).

الزامی مکان

حاوی اطلاعات دقیق درباره مکان درخواست‌شده است.

برای اطلاعات بیشتر، مکان را ببینید.

الزامی PlacesDetailsStatus

حاوی وضعیت درخواست است و ممکن است حاوی اطلاعات اشکال‌زدایی باشد تا به شما کمک کند دلیل ناموفق بودن درخواست را پیدا کنید.

برای اطلاعات بیشتر، PlacesDetailsStatus را ببینید.

اختیاری آرایه<رشته>

وقتی سرویس اطلاعات بیشتری درباره مشخصات درخواست برمی‌گرداند، ممکن است فیلد info_messages دیگری در شیء پاسخ وجود داشته باشد. این فیلد فقط برای درخواست‌های موفق برگردانده می‌شود. ممکن است همیشه برگردانده نشود و محتوای آن مشمول تغییر است.

در پاسخ JSON، این موارد به‌عنوان عناصر ریشه نشان داده می‌شوند. در پاسخ XML، این موارد به‌عنوان عناصر سطح بالا در زیر <PlaceDetailsResponse> ظاهر می‌شوند.

PlacesDetailsStatus

رمزهای وضعیت برگردانده‌شده توسط سرویس.

  • OK که نشان می‌دهد درخواست API موفقیت‌آمیز بوده است.
  • ‫ZERO_RESULTS نشان می‌دهد که مکان ارجاع‌داده‌شده، place_id، معتبر بوده است اما دیگر به نتیجه معتبری ارجاع نمی‌دهد. این ممکن است درصورتی رخ دهد که مؤسسه دیگر کسب‌وکار نداشته باشد.
  • ‫NOT_FOUND نشان می‌دهد که مکان ارجاع‌داده‌شده، place_id، در پایگاه داده «مکان‌ها» پیدا نشد.
  • ‫INVALID_REQUEST نشان می‌دهد که درخواست میانای برنامه‌سازی کاربردی ناقص بوده است.
  • OVER_QUERY_LIMIT نشان‌دهنده هریک از موارد زیر:
    • از حد مجاز «پرس‌وجو در ثانیه» فراتر رفته‌اید.
    • صورت‌حساب در حسابتان فعال نشده است.
    • از اعتبار ماهانه ۲۰۰ دلار یا سقف استفاده خودتحمیلی فراتر رفته‌اید.
    • روش پرداخت ارائه‌شده دیگر معتبر نیست (برای مثال، کارت اعتباری منقضی شده است).
    برای اطلاعات بیشتر درباره نحوه برطرف کردن این خطا، پرسشگان Maps را ببینید.
  • REQUEST_DENIED که نشان می‌دهد درخواست شما رد شده است، معمولاً به این دلیل:
    • درخواست کلید میانای برنامه‌سازی کاربردی ندارد.
    • پارامتر key نامعتبر است.
  • ‫UNKNOWN_ERROR نشان‌دهنده خطای ناشناخته.

جا

مشخصه‌هایی که مکان را توصیف می‌کند. همه مشخصه‌ها برای همه انواع مکان دردسترس نیستند.

فیلد الزامی نوع شرح
اختیاری Array<AddressComponent>

آرایه‌ای حاوی مؤلفه‌های جداگانه قابل‌اعمال برای این نشانی.

برای اطلاعات بیشتر، به AddressComponent بروید.

اختیاری رشته

نمایشی از نشانی مکان در ریزفرمت adr.

اختیاری رشته

وضعیت عملیاتی مکان را نشان می‌دهد، اگر کسب‌وکار باشد. اگر داده‌ای وجود نداشته باشد، business_status برگردانده نمی‌شود.

The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
اختیاری بولی

مشخص می‌کند که آیا کسب‌وکار از تحویل کنار خیابان پشتیبانی می‌کند یا نه.

اختیاری PlaceOpeningHours

شامل ساعات کاری برای هفت روز آینده (ازجمله امروز) می‌شود. این دوره زمانی از نیمه‌شب تاریخ درخواست شروع می‌شود و در ساعت ۱۱:۵۹ شب شش روز بعد پایان می‌یابد. این فیلد شامل زیرفیلد special_days برای همه ساعت‌ها است که برای تاریخ‌هایی تنظیم شده است که ساعت کاری استثنایی دارند.

برای اطلاعات بیشتر، PlaceOpeningHours را ببینید.

اختیاری بولی

مشخص می‌کند که آیا کسب‌وکار از ارسال پشتیبانی می‌کند یا نه.

اختیاری بولی

مشخص می‌کند که آیا کسب‌وکار از گزینه‌های جای نشستن در فضای باز یا سرپوشیده پشتیبانی می‌کند یا نه.

اختیاری PlaceEditorialSummary

حاوی خلاصه‌ای از مکان است. خلاصه شامل یک نمای کلی نوشتاری است و درصورت قابل‌اعمال بودن، کد زبان را نیز دربرمی‌گیرد. متن خلاصه باید همان‌گونه که هست ارائه شود و نمی‌تواند اصلاح یا تغییر داده شود.

برای اطلاعات بیشتر، PlaceEditorialSummary را ببینید.

اختیاری رشته

رشته‌ای حاوی نشانی قابل‌خواندن برای انسان این مکان.

اغلب این نشانی معادل نشانی پستی است. توجه داشته باشید که برخی‌از کشورها، مانند پادشاهی متحد، به‌دلیل محدودیت‌های صدور پروانه، توزیع نشانی‌های پستی واقعی را مجاز نمی‌دانند.

نشانی قالب‌بندی‌شده به‌طور منطقی از یک یا چند مؤلفه نشانی تشکیل شده است. برای مثال، نشانی «111 8th Avenue, New York, NY» از اجزای زیر تشکیل شده است: «111» (شماره خیابان)، «8th Avenue» (مسیر)، «New York» (شهر)، و «NY» (ایالت ایالات متحده).

نشانی قالب‌بندی‌شده را به‌صورت برنامه‌نویسی تجزیه نکنید. درعوض، باید از عناصر نشانی جداگانه استفاده کنید که پاسخ API علاوه‌بر فیلد نشانی قالب‌بندی‌شده، آن‌ها را نیز دربرمی‌گیرد.

اختیاری رشته

حاوی شماره تلفن مکان در قالب محلی آن است.

اختیاری Geometry

مکان و درگاه دید مکان را دربرمی‌گیرد.

برای اطلاعات بیشتر، به Geometry بروید.

اختیاری رشته

حاوی نشانی وب نماد پیشنهادی است که ممکن است هنگام نشان دادن این نتیجه روی نقشه به کاربر نمایش داده شود.

اختیاری رشته

حاوی کد رنگ HEX پیش‌فرض برای دسته مکان است.

اختیاری رشته

حاوی نشانی وب نماد توصیه‌شده، منهای .svg یا .png افزونه نوع فایل.

اختیاری رشته

شماره تلفن مکان را در قالب بین‌المللی دارد. قالب بین‌المللی شامل کد کشور است و با علامت به‌علاوه، +، پیشوندگذاری می‌شود. برای مثال، international_phone_number برای دفتر Google در سیدنی استرالیا +61 2 9374 4000 است.

اختیاری رشته

حاوی نام قابل‌خواندن برای انسان برای نتیجه برگردانده‌شده است. برای establishment نتیجه، این معمولاً نام کسب‌وکار متعارف است.

اختیاری PlaceOpeningHours

شامل ساعات کاری معمول است.

برای اطلاعات بیشتر، به PlaceOpeningHours مراجعه کنید.

اختیاری بولی

از business_status برای دریافت وضعیت عملیاتی کسب‌وکارها استفاده کنید.

اختیاری Array<PlacePhoto>

آرایه‌ای از اشیای عکس که هرکدام حاوی ارجاع به تصویر است. درخواست ممکن است تا ده عکس را برگرداند. اطلاعات بیشتر درباره عکس‌های مکان و نحوه استفاده از تصاویر در برنامه‌تان را می‌توانید در مستندات عکس‌های مکان پیدا کنید.

برای اطلاعات بیشتر، PlacePhoto را ببینید.

اختیاری رشته

شناسه نوشتاری که مکان را به‌طور یکتا شناسایی می‌کند. برای بازیابی اطلاعات مربوط به مکان، این شناسه را در فیلد place_id درخواست «میانای برنامه‌سازی کاربردی مکان‌ها» بگذرانید. برای اطلاعات بیشتر درباره شناسه‌های مکان، نمای کلی شناسه مکان را ببینید.

اختیاری PlusCode

مرجع مکان کدبندی‌شده، برگرفته از مختصات طول و عرض جغرافیایی که نشان‌دهنده یک منطقه است: ۱/۸۰۰۰ درجه در ۱/۸۰۰۰ درجه (حدود ۱۴ متر در ۱۴ متر در خط استوا) یا کوچک‌تر. از کدهای باز می‌توان به‌عنوان جایگزین نشانی خیابان در مکان‌هایی که نشانی خیابان وجود ندارد (ساختمان‌ها شماره‌گذاری نشده‌اند یا خیابان‌ها نام‌گذاری نشده‌اند) استفاده کرد. کد مکان باز و کدهای باز را ببینید.

برای اطلاعات بیشتر، به PlusCode بروید.

اختیاری شماره

سطح قیمت مکان، در مقیاس ۰ تا ۴. مقدار دقیق نشان‌داده‌شده با یک مقدار خاص از منطقه‌ای به منطقه دیگر متفاوت خواهد بود. سطوح قیمت به‌صورت زیر تفسیر می‌شود:

  • ‫۰ رایگان
  • ‫۱ ارزان
  • ‫۲ متوسط
  • ‫۳ گران
  • ‫۴ بسیار گران
اختیاری شماره

شامل رده‌بندی مکان، از ۱٫۰ تا ۵٫۰، براساس مرورهای انبوهیده کاربر است.

اختیاری رشته
اختیاری بولی

مشخص می‌کند که مکان از رزرو پشتیبانی می‌کند یا نه.

اختیاری Array<PlaceReview>

آرایه JSON حداکثر پنج مرور. به‌طور پیش‌فرض، مرورها براساس ترتیب مربوط بودن مرتب می‌شوند. از پارامتر درخواست reviews_sort برای کنترل مرتب‌سازی استفاده کنید.

  • برای most_relevant (پیش‌فرض)، مرورها براساس میزان مربوط بودن مرتب می‌شوند؛ سرویس نتایج را به‌سمت برگرداندن مرورهایی که دراصل به زبان ترجیحی نوشته شده‌اند متمایل می‌کند.
  • برای newest، مرورها به‌ترتیب زمانی مرتب می‌شوند؛ زبان ترجیحی بر ترتیب مرتب‌سازی تأثیر نمی‌گذارد.

Google توصیه می‌کند به کاربران نشان دهید که نتایج براساس most_relevant یا newest مرتب شده‌اند.

برای اطلاعات بیشتر، PlaceReview را ببینید.

اختیاری رشته ‫
اختیاری Array<PlaceOpeningHours>

حاوی آرایه‌ای از ورودی‌ها برای هفت روز آینده است، ازجمله اطلاعاتی درباره ساعت کاری فرعی کسب‌وکار. ساعت کاری فرعی با ساعت کاری اصلی کسب‌وکار متفاوت است. برای مثال، رستوران می‌تواند ساعت‌های بگیر و بران یا ساعت‌های ارسال را به‌عنوان ساعت‌های ثانویه خود مشخص کند. این فیلد زیرفیلد type را تکمیل می‌کند که براساس نوع مکان، از فهرست پیش‌تعریف‌شده‌ای از انواع ساعات کاری (مثل DRIVE_THROUGH، PICKUP، یا TAKEOUT) استفاده می‌کند. این فیلد شامل special_days زیرفیلد همه ساعت‌ها است که برای تاریخ‌هایی که ساعت کاری استثنایی دارند تنظیم شده است.

برای اطلاعات بیشتر، به PlaceOpeningHours مراجعه کنید.

اختیاری بولی

مشخص می‌کند که آیا این مکان آبجو سرو می‌کند یا نه.

اختیاری بولی

مشخص می‌کند که آیا این مکان صبحانه سرو می‌کند یا نه.

اختیاری بولی

مشخص می‌کند که آیا این مکان چاشت نیمروز سرو می‌کند یا نه.

اختیاری بولی

مشخص می‌کند که آیا این مکان شام سرو می‌کند یا نه.

اختیاری بولی

مشخص می‌کند که آیا در این مکان ناهار سرو می‌شود یا نه.

اختیاری بولی

مشخص می‌کند که آیا این مکان غذای گیاهی سرو می‌کند یا نه.

اختیاری بولی

مشخص می‌کند که آیا مکان شراب سرو می‌کند یا نه.

اختیاری بولی

مشخص می‌کند که آیا کسب‌وکار از تحویل در فروشگاه پشتیبانی می‌کند یا نه.

اختیاری Array<string>

شامل آرایه‌ای از انواع ویژگی‌هایی است که نتیجه داده‌شده را توصیف می‌کند. فهرست انواع پشتیبانی‌شده را ببینید.

اختیاری رشته

حاوی نشانی وب صفحه رسمی Google برای این مکان است. این صفحه متعلق به Google خواهد بود که حاوی بهترین اطلاعات موجود درباره آن مکان است. برنامه‌ها باید در هر صفحه‌ای که نتایج دقیق درباره مکان را به کاربر نشان می‌دهد، به این صفحه پیوند دهند یا آن را جاسازی کنند.

اختیاری شماره

تعداد کل مرورها، با نوشتار یا بدون نوشتار، برای این مکان.

اختیاری شماره

شامل تعداد دقیقه‌هایی است که منطقه زمانی فعلی این مکان از «ساعت هماهنگ جهانی» انحراف دارد. برای مثال، برای مکان‌های سیدنی، استرالیا درطول ساعت تابستانی، این مقدار ۶۶۰ (+۱۱ ساعت از ساعت هماهنگ جهانی) خواهد بود، و برای مکان‌های کالیفرنیا خارج از ساعت تابستانی، این مقدار -۴۸۰ (-۸ ساعت از ساعت هماهنگ جهانی) خواهد بود.

اختیاری رشته

برای مؤسسه (types:["establishment", ...]) فقط نتایج)، فیلد vicinity حاوی نشانی ساده‌شده‌ای برای مکان است که شامل نام خیابان، شماره خیابان، و محله می‌شود، اما استان/ایالت، کد پستی، یا کشور را دربرنمی‌گیرد.

برای همه نتایج دیگر، فیلد vicinity حاوی نام باریک‌ترین ویژگی سیاسی (types:["political", ...]) است که در نشانی نتیجه وجود دارد.

این محتوا باید همان‌گونه که هست خوانده شود. نشانی قالب‌بندی‌شده را به‌صورت برنامه‌ریزی‌شده تجزیه نکنید.

اختیاری رشته

وب‌سایت معتبر این مکان، مثل صفحه اصلی کسب‌وکار.

اختیاری بولی

مشخص می‌کند که مکان ورودی دسترس‌پذیر با صندلی چرخدار دارد یا نه.

PlaceEditorialSummary

حاوی خلاصه‌ای از مکان است. خلاصه شامل یک نمای کلی نوشتاری است، و درصورت وجود، کد زبان را نیز دربرمی‌گیرد. نوشتار خلاصه باید همان‌طور که هست ارائه شود و نمی‌توان آن را اصلاح یا تغییر داد.

فیلد الزامی نوع شرح
اختیاری رشته

زبان فیلدهای قبلی. ممکن است همیشه حضور نداشته باشد.

اختیاری رشته

خلاصه‌ای نوشتاری با طول متوسط از مکان.

PlaceOpeningHours

شیئی که ساعات کاری مکان را توصیف می‌کند.

فیلد الزامی نوع شرح
اختیاری بولی

مقدار بولی که نشان می‌دهد مکان در زمان فعلی باز است یا نه.

اختیاری Array<PlaceOpeningHoursPeriod>

آرایه‌ای از دوره‌های باز بودن که هفت روز را پوشش می‌دهد و از یکشنبه شروع می‌شود و به‌ترتیب زمانی است.

برای اطلاعات بیشتر، PlaceOpeningHoursPeriod را ببینید.

اختیاری Array<PlaceSpecialDay>

آرایه‌ای از حداکثر هفت ورودی مربوط به هفت روز آینده.

برای اطلاعات بیشتر، PlaceSpecialDay را ببینید.

اختیاری رشته

رشته نوعی که برای شناسایی نوع ساعات کاری فرعی استفاده می‌شود (برای مثال، DRIVE_THROUGH، HAPPY_HOUR، DELIVERY، TAKEOUT، KITCHEN، BREAKFAST، LUNCH، DINNER، BRUNCH، PICKUP، SENIOR_HOURS). فقط برای secondary_opening_hours تنظیم می‌شود.

اختیاری Array<string>

آرایه‌ای از رشته‌ها که ساعات کاری مکان را با نوشتار قابل‌خواندن برای انسان توصیف می‌کند.

PlaceOpeningHoursPeriod

فیلد الزامی نوع شرح
الزامی PlaceOpeningHoursPeriodDetail

حاوی جفتی از اشیای روز و زمان است که زمان باز شدن مکان را شرح می‌دهد.

برای اطلاعات بیشتر، PlaceOpeningHoursPeriodDetail را ببینید.

اختیاری PlaceOpeningHoursPeriodDetail

ممکن است حاوی یک جفت شیء روز و زمان باشد که زمان بسته شدن مکان را توصیف می‌کند. اگر مکانی همیشه باز باشد، بخش بسته شدن در پاسخ وجود نخواهد داشت. کاربران می‌توانند همیشه باز بودن را به‌عنوان دوره باز حاوی روز با مقدار 0 و زمان با مقدار 0000 و بدون close درنظر بگیرند.

برای اطلاعات بیشتر، PlaceOpeningHoursPeriodDetail را ببینید.

PlaceSpecialDay

فیلد الزامی نوع شرح
اختیاری رشته

تاریخی که در قالب RFC3339 در منطقه زمانی محلی برای مکان بیان شده است، برای مثال 2010-12-31.

اختیاری بولی

اگر ساعت کاری استثنایی برای این روز وجود داشته باشد، درست است. اگر true، یعنی برای این روز حداقل یک استثنا وجود دارد. استثناها باعث می‌شوند مقادیر مختلفی در زیرفیلدهای current_opening_hours و secondary_opening_hours مانند periods، weekday_text، open_now رخ دهد. استثناها برای ساعت‌ها اعمال می‌شود و از ساعت‌ها برای تولید کردن فیلدهای دیگر استفاده می‌شود.

PlaceOpeningHoursPeriodDetail

فیلد الزامی نوع شرح
الزامی شماره

عددی از ۰ تا ۶ که با روزهای هفته مطابقت دارد و از یکشنبه شروع می‌شود. برای مثال، ۲ یعنی سه‌شنبه.

الزامی رشته

ممکن است حاوی زمان روز در قالب ۲۴ ساعته hhmm باشد. مقادیر در محدوده ۰۰۰۰ تا ۲۳۵۹ است. زمان براساس منطقه زمانی مکان گزارش خواهد شد.

اختیاری رشته

تاریخی که در قالب RFC3339 در منطقه زمانی محلی برای مکان بیان شده است، برای مثال 2010-12-31.

اختیاری بولی

اگر دوره معینی به‌دلیل قطع هفت روزه کوتاه شده باشد، که در آن دوره قبل‌از نیمه‌شب در تاریخ درخواست شروع می‌شود و/یا در نیمه‌شب یا بعداز آن در آخرین روز پایان می‌یابد، مقدار True است. این دارایی نشان می‌دهد که دوره باز یا بسته بودن می‌تواند از این مهلت هفت روزه فراتر رود.

PlacePhoto

عکس «مکان». بااستفاده از Place Photo API و بااستفاده از نشانی وب در الگوی زیر می‌توان به عکس دسترسی پیدا کرد:

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

برای اطلاعات بیشتر، عکس‌های مکان را ببینید.

فیلد الزامی نوع شرح
الزامی شماره

ارتفاع عکس.

الزامی آرایه<رشته>

ارجاع‌های HTML برای عکس.

الزامی رشته

رشته‌ای که برای شناسایی عکس هنگام درخواست «عکس» استفاده می‌شود.

الزامی شماره

عرض عکس.

PlaceReview

مرور مکان که توسط کاربر ارسال شده است.

فیلد الزامی نوع شرح
الزامی رشته

نام کاربری که مرور را ارسال کرده است. مرورهای ناشناس به «کاربر Google» نسبت داده می‌شود.

الزامی شماره

رده‌بندی کلی کاربر برای این مکان. این عدد صحیح است و از ۱ تا ۵ متغیر است.

الزامی رشته

زمان ارسال مرور به‌صورت نوشتاری، نسبت به زمان فعلی.

الزامی شماره

زمان ارسال مرور، که برحسب تعداد ثانیه از نیمه‌شب ۱ ژانویه ۱۹۷۰ به وقت ساعت هماهنگ جهانی (UTC) اندازه‌گیری می‌شود.

اختیاری رشته

نشانی وب نمایه «راهنمای محلی Google Maps» کاربر، درصورت دردسترس بودن.

اختیاری رشته

کد زبان IETF که نشان‌دهنده زبان مرور برگشتی است.این فیلد فقط حاوی برچسب زبان اصلی است و نه برچسب ثانویه که نشان‌دهنده کشور یا منطقه است. برای مثال، همه مرورهای انگلیسی با برچسب «en» نشان‌گذاری می‌شوند، نه «en-AU» یا «en-UK» و غیره.اگر فقط رده‌بندی بدون نوشتار مرور وجود داشته باشد، این فیلد خالی است.

اختیاری رشته

کد زبان IETF که نشان‌دهنده زبان اصلی مرور است. اگر مرور ترجمه شده باشد، آنگاه original_language != language.این فیلد فقط برچسب زبان اصلی را دارد و نه برچسب ثانویه که نشان‌دهنده کشور یا منطقه است. برای مثال، همه مرورهای انگلیسی با برچسب «en» نشان‌گذاری می‌شوند، نه «en-AU» یا «en-UK» و غیره.اگر فقط رده‌بندی بدون نوشتار مرور وجود داشته باشد، این فیلد خالی است.

اختیاری رشته

نشانی وب عکس نمایه کاربر، درصورت دردسترس بودن.

اختیاری رشته

مرور کاربر. هنگام مرور مکان با Google Places، مرورهای نوشتاری اختیاری درنظر گرفته می‌شوند. بنابراین، این فیلد ممکن است خالی باشد. توجه داشته باشید که این فیلد ممکن است شامل نشانه‌گذاری HTML پایه باشد. برای مثال، مرجع نهاد &amp; ممکن است نشان‌دهنده نویسه «و» باشد.

اختیاری بولی

مقدار بولی که نشان می‌دهد آیا مرور از زبان اصلی که به آن نوشته شده ترجمه شده است یا نه.اگر مروری ترجمه شده باشد، مطابق با مقدار true، Google توصیه می‌کند که این موضوع را به کاربران خود نشان دهید. برای مثال، می‌توانید رشته زیر، «ترجمه‌شده توسط Google»، را به مرور اضافه کنید.