این محصول یا ویژگی در وضعیت Legacy است. برای اطلاعات بیشتر درباره وضعیت Legacy به محصولات و ویژگی های Legacy مراجعه کنید. برای انتقال به Places API (جدید)، به راهنمای مهاجرت مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

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

نکته: کتابخانه‌های سمت سرور و سمت کلاینت

API مکان‌ها همچنین با Java Client، Python Client، Go Client و Node.js Client برای سرویس‌های نقشه‌های گوگل در دسترس است. API مکان‌ها و کتابخانه‌های کلاینت برای استفاده در برنامه‌های سرور هستند.

اگر در حال ساخت یک برنامه سمت کلاینت هستید، نگاهی به Places SDK برای اندروید (جدید) ، Places SDK برای iOS (جدید) و کتابخانه Places و Maps JavaScript API بیندازید.

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

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

درخواست جزئیات مکان (Legacy) یک URL HTTP به شکل زیر است:

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

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

json (توصیه می‌شود) خروجی را در قالب نشانه‌گذاری شیء جاوا اسکریپت (JSON) نشان می‌دهد.
xml خروجی را به صورت XML نشان می‌دهد

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

پارامترهای مورد نیاز

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

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

زمینه‌ها
احتیاط: درخواست‌های جستجوی مکان و درخواست‌های جزئیات مکان، فیلدهای یکسانی را برنمی‌گردانند. درخواست‌های جستجوی مکان، زیرمجموعه‌ای از فیلدهایی را که توسط درخواست‌های جزئیات مکان برگردانده می‌شوند، برمی‌گردانند. اگر فیلد مورد نظر شما توسط جستجوی مکان برگردانده نمی‌شود، می‌توانید از جستجوی مکان برای دریافت place_id استفاده کنید، سپس از آن شناسه مکان برای ایجاد درخواست جزئیات مکان استفاده کنید. برای اطلاعات بیشتر در مورد فیلدهایی که در درخواست جستجوی مکان در دسترس نیستند، به پشتیبانی از فیلدهای API مکان‌ها مراجعه کنید.
از پارامتر fields برای مشخص کردن لیستی از انواع داده‌های مکانی که با کاما از هم جدا شده‌اند و قرار است برگردانده شوند، استفاده کنید. برای مثال: fields=formatted_address,name,geometry . هنگام مشخص کردن مقادیر ترکیبی، از اسلش رو به جلو استفاده کنید. برای مثال: opening_hours/open_now .
فیلدها به سه دسته صورتحساب تقسیم می‌شوند: پایه ، تماس و اتمسفر . SKU های پایه، تماس و اتمسفر علاوه بر SKU پایه (جزئیات مکان‌ها، یافتن مکان، جستجوی نزدیک یا جستجوی متن) برای درخواستی که آنها را فعال کرده است، هزینه دریافت می‌کنند. برای اطلاعات بیشتر، به برگه قیمت‌گذاری مراجعه کنید.
پایه
دسته پایه شامل فیلدهای زیر است: 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
جو
دسته‌بندی Atmosphere شامل فیلدهای زیر است: 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 .
نکته: Attributionها، html_attributions ، همیشه با هر فراخوانی برگردانده می‌شوند، صرف نظر از اینکه آیا فیلد درخواست شده است یا خیر.
زبان
زبانی که نتایج با آن برگردانده می‌شوند.
- فهرست زبان‌های پشتیبانی‌شده را ببینید. گوگل اغلب زبان‌های پشتیبانی‌شده را به‌روزرسانی می‌کند، بنابراین این فهرست ممکن است جامع نباشد.
- اگر language ارائه نشود، API تلاش می‌کند از زبان ترجیحی مشخص شده در سربرگ Accept-Language استفاده کند.
- این API تمام تلاش خود را می‌کند تا آدرسی را ارائه دهد که هم برای کاربر و هم برای افراد محلی قابل خواندن باشد. برای دستیابی به این هدف، آدرس‌های خیابان را به زبان محلی برمی‌گرداند و در صورت لزوم با رعایت زبان ترجیحی، آنها را به اسکریپتی که توسط کاربر قابل خواندن باشد، تبدیل می‌کند. تمام آدرس‌های دیگر به زبان ترجیحی برگردانده می‌شوند. اجزای آدرس همگی به همان زبانی برگردانده می‌شوند که از اولین جزء انتخاب شده است.
- اگر نامی در زبان مورد نظر موجود نباشد، API از نزدیکترین مورد منطبق استفاده می‌کند.
- زبان ترجیحی تأثیر کمی بر مجموعه نتایجی که API برای برگرداندن انتخاب می‌کند و ترتیب برگرداندن آنها دارد. کدگذار جغرافیایی بسته به زبان، اختصارات را به طور متفاوتی تفسیر می‌کند، مانند اختصارات مربوط به انواع خیابان، یا مترادف‌هایی که ممکن است در یک زبان معتبر باشند اما در زبان دیگر معتبر نباشند. به عنوان مثال، utca و tér مترادف خیابان در زبان مجارستانی هستند.
منطقه
کد منطقه، که به عنوان یک مقدار دو کاراکتری ccTLD ("دامنه سطح بالا") مشخص شده است. اکثر کدهای ccTLD با کدهای ISO 3166-1 یکسان هستند، با برخی استثنائات قابل توجه. به عنوان مثال، ccTLD بریتانیا "uk" (.co.uk) است در حالی که کد ISO 3166-1 آن "gb" است (از نظر فنی برای موجودیت "پادشاهی متحده بریتانیای کبیر و ایرلند شمالی").
نقد و بررسی‌ها بدون ترجمه
برای غیرفعال کردن ترجمه نظرات reviews_no_translations=true و برای فعال کردن ترجمه نظرات reviews_no_translations=false را مشخص کنید. نظرات به زبان اصلی خود برگردانده می‌شوند.
اگر حذف شود یا بدون مقدار ارسال شود، ترجمه نظرات فعال می‌شود. اگر پارامتر language در درخواست مشخص شده باشد، از زبان مشخص شده به عنوان زبان ترجیحی برای ترجمه استفاده کنید. اگر language حذف شود، API تلاش می‌کند از هدر Accept-Language به عنوان زبان ترجیحی استفاده کند.
بررسی‌ها_مرتب‌سازی
روش مرتب‌سازی مورد استفاده هنگام بازگرداندن نظرات. می‌تواند روی most_relevant (پیش‌فرض) یا newest تنظیم شود.
- برای most_relevant (پیش‌فرض)، نقدها بر اساس میزان مرتبط بودن مرتب می‌شوند؛ این سرویس نتایج را طوری تنظیم می‌کند که نقدهایی را که در ابتدا به زبان دلخواه نوشته شده‌اند، برگرداند.
- برای newest ، نقدها به ترتیب زمانی مرتب می‌شوند؛ زبان مورد نظر تاثیری بر ترتیب مرتب‌سازی ندارد.
گوگل توصیه می‌کند که نحوه‌ی مرتب‌سازی نظرات را به کاربر نهایی نشان دهید.
توکن جلسه
یک رشته تصادفی که یک جلسه تکمیل خودکار را برای اهداف صورتحساب مشخص می‌کند.
جلسه زمانی شروع می‌شود که کاربر شروع به تایپ یک پرس‌وجو می‌کند و زمانی که یک مکان را انتخاب می‌کند و فراخوانی Place Details انجام می‌شود، پایان می‌یابد. هر جلسه می‌تواند چندین پرس‌وجو داشته باشد و پس از آن یک مکان انتخاب شود. کلید(های) API مورد استفاده برای هر درخواست در یک جلسه باید متعلق به همان پروژه Google Cloud Console باشد. پس از پایان یک جلسه، توکن دیگر معتبر نیست؛ برنامه شما باید برای هر جلسه یک توکن جدید تولید کند. اگر پارامتر sessiontoken حذف شود، یا اگر از یک توکن جلسه دوباره استفاده کنید، هزینه جلسه طوری محاسبه می‌شود که انگار هیچ توکن جلسه‌ای ارائه نشده است (هزینه هر درخواست جداگانه محاسبه می‌شود).
ما دستورالعمل‌های زیر را توصیه می‌کنیم:
- از توکن‌های جلسه برای تمام جلسات تکمیل خودکار استفاده کنید.
- برای هر جلسه یک توکن جدید ایجاد کنید. استفاده از UUID نسخه ۴ توصیه می‌شود.
- مطمئن شوید که کلید(های) API مورد استفاده برای همه درخواست‌های Place Autocomplete و Place Details در یک جلسه متعلق به یک پروژه Cloud Console باشند.
- حتماً برای هر جلسه جدید، یک توکن جلسه منحصر به فرد ارسال کنید. استفاده از یک توکن برای بیش از یک جلسه منجر به این می‌شود که برای هر درخواست، هزینه جداگانه محاسبه شود.

هشدار: اگر حداقل یک فیلد را در درخواست مشخص نکنید، یا اگر پارامتر fields را از درخواست حذف کنید، تمام فیلدهای ممکن بازگردانده می‌شوند و بر اساس آن هزینه برای شما محاسبه خواهد شد. این فقط برای درخواست‌های Place Details (Legacy) اعمال می‌شود.

مثال جزئیات مکان (میراث)

مثال زیر جزئیات یک مکان را با استفاده از 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'

اچ‌تی‌پی

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

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

پاسخ جزئیات مکان (میراث)

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

جی‌سون

{
  "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 هر کدام شامل عناصر زیر هستند:

جزئیات مکان‌هاپاسخ

میدان	مورد نیاز	نوع	توضیحات
`html_attributions`	مورد نیاز	آرایه	ممکن است شامل مجموعه‌ای از ویژگی‌ها در مورد این فهرست باشد که باید به کاربر نمایش داده شود (برخی از فهرست‌ها ممکن است ویژگی نداشته باشند).
`result`	مورد نیاز	مکان	شامل اطلاعات دقیق در مورد مکان مورد نظر است. برای اطلاعات بیشتر به مکان مراجعه کنید.
`status`	مورد نیاز	جزئیات مکان‌هاوضعیت	شامل وضعیت درخواست است و ممکن است حاوی اطلاعات اشکال‌زدایی باشد تا به شما در پیگیری دلیل عدم موفقیت درخواست کمک کند. برای اطلاعات بیشتر به PlacesDetailsStatus مراجعه کنید.
`info_messages`	اختیاری	آرایه	وقتی سرویس اطلاعات اضافی در مورد مشخصات درخواست را برمی‌گرداند، ممکن است یک فیلد `info_messages` اضافی در شیء پاسخ وجود داشته باشد. این فیلد فقط برای درخواست‌های موفق برگردانده می‌شود. ممکن است همیشه برگردانده نشود و محتوای آن قابل تغییر است.

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

جزئیات مکان‌هاوضعیت

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

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

مکان

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

میدان	مورد نیاز	نوع	توضیحات
`address_components`	اختیاری	آرایه `AddressComponent`	آرایه‌ای شامل اجزای جداگانه‌ای که برای این آدرس قابل استفاده هستند. برای اطلاعات بیشتر به `AddressComponent` مراجعه کنید.
`adr_address`	اختیاری	رشته	نمایشی از آدرس مکان در ریزفرمت ADR .
`business_status`	اختیاری	رشته	وضعیت عملیاتی مکان را نشان می‌دهد، اگر یک کسب و کار باشد. اگر داده‌ای وجود نداشته باشد، `business_status` برگردانده نمی‌شود. The allowed values include: `OPERATIONAL` , `CLOSED_TEMPORARILY` , and `CLOSED_PERMANENTLY`
`curbside_pickup`	اختیاری	بولی	مشخص می‌کند که آیا کسب و کار از تحویل کنار خیابان پشتیبانی می‌کند یا خیر.
`current_opening_hours`	اختیاری	ساعات کاری مکان	شامل ساعات کاری برای هفت روز آینده (شامل امروز) است. این دوره زمانی از نیمه‌شب تاریخ درخواست شروع می‌شود و شش روز بعد در ساعت ۱۱:۵۹ شب به پایان می‌رسد. این فیلد شامل زیرفیلد `special_days` مربوط به همه ساعات است که برای تاریخ‌هایی که ساعات کاری استثنایی دارند تنظیم شده است. برای اطلاعات بیشتر به PlaceOpeningHours مراجعه کنید.
`delivery`	اختیاری	بولی	مشخص می‌کند که آیا کسب‌وکار از تحویل پشتیبانی می‌کند یا خیر.
`dine_in`	اختیاری	بولی	مشخص می‌کند که آیا کسب‌وکار از گزینه‌های نشستن در فضای داخلی یا خارجی پشتیبانی می‌کند یا خیر.
`editorial_summary`	اختیاری	خلاصه سرمقاله مکان	شامل خلاصه‌ای از مکان است. خلاصه شامل یک مرور متنی است و در صورت لزوم شامل کد زبان برای این موارد نیز می‌شود. متن خلاصه باید به همان شکلی که هست ارائه شود و قابل اصلاح یا تغییر نیست. برای اطلاعات بیشتر به PlaceEditorSummary مراجعه کنید.
`formatted_address`	اختیاری	رشته	رشته‌ای حاوی آدرس قابل خواندن توسط انسان از این مکان. اغلب این آدرس معادل آدرس پستی است. توجه داشته باشید که برخی کشورها، مانند بریتانیا، به دلیل محدودیت‌های صدور مجوز، اجازه توزیع آدرس‌های پستی واقعی را نمی‌دهند. آدرس قالب‌بندی شده به طور منطقی از یک یا چند جزء آدرس تشکیل شده است. برای مثال، آدرس "111 خیابان هشتم، نیویورک، نیویورک" از اجزای زیر تشکیل شده است: "111" (شماره خیابان)، "خیابان هشتم" (مسیر)، "نیویورک" (شهر) و "NY" (ایالت آمریکا). آدرس فرمت‌شده را به صورت برنامه‌نویسی تجزیه نکنید. در عوض، باید از اجزای آدرس منفرد استفاده کنید که پاسخ API علاوه بر فیلد آدرس فرمت‌شده، شامل آن‌ها نیز می‌شود.
`formatted_phone_number`	اختیاری	رشته	شامل شماره تلفن محل در قالب محلی آن است.
`geometry`	اختیاری	`Geometry`	شامل مکان و دریچه دید برای مکان است. برای اطلاعات بیشتر `Geometry` مراجعه کنید.
`icon`	اختیاری	رشته	حاوی نشانی اینترنتی (URL) یک نماد پیشنهادی است که ممکن است هنگام نشان دادن این نتیجه روی نقشه به کاربر نمایش داده شود.
`icon_background_color`	اختیاری	رشته	شامل کد رنگ HEX پیش‌فرض برای دسته‌بندی مکان است.
`icon_mask_base_uri`	اختیاری	رشته	شامل آدرس اینترنتی یک آیکون پیشنهادی، منهای پسوند فایل `.svg` یا `.png` است.
`international_phone_number`	اختیاری	رشته	شامل شماره تلفن محل در قالب بین‌المللی است. قالب بین‌المللی شامل کد کشور است و با علامت بعلاوه، +، پیشوند می‌گیرد. برای مثال، شماره تلفن بین‌المللی برای دفتر گوگل در سیدنی، استرالیا `+61 2 9374 4000` است.
`name`	اختیاری	رشته	شامل نام قابل خواندن توسط انسان برای نتیجه‌ی برگشتی است. برای نتایج `establishment` ، این معمولاً نام تجاری استاندارد شده است.
`opening_hours`	اختیاری	ساعات کاری مکان	شامل ساعات کاری معمول است. برای اطلاعات بیشتر به PlaceOpeningHours مراجعه کنید.
`permanently_closed`	اختیاری	بولی	`permanently_closed` منسوخ شده است. برای دریافت وضعیت عملیاتی کسب‌وکارها از `business_status` استفاده کنید.
`photos`	اختیاری	آرایه< عکس مکان >	آرایه‌ای از اشیاء عکس، که هر کدام شامل ارجاعی به یک تصویر هستند. یک درخواست ممکن است تا ده عکس را برگرداند. اطلاعات بیشتر در مورد عکس‌های مکان و نحوه استفاده از تصاویر در برنامه‌تان را می‌توانید در مستندات عکس‌های مکان بیابید. برای اطلاعات بیشتر به PlacePhoto مراجعه کنید.
`place_id`	اختیاری	رشته	یک شناسه متنی که به طور منحصر به فرد یک مکان را مشخص می‌کند. برای بازیابی اطلاعات در مورد مکان، این شناسه را در فیلد `place_id` از یک درخواست Places API ارسال کنید. برای اطلاعات بیشتر در مورد شناسه‌های مکان، به نمای کلی شناسه مکان مراجعه کنید.
`plus_code`	اختیاری	`PlusCode`	یک مرجع مکانی کدگذاری‌شده، مشتق‌شده از مختصات طول و عرض جغرافیایی، که نشان‌دهنده‌ی یک منطقه است: ۱/۸۰۰۰ درجه در ۱/۸۰۰۰ درجه (حدود ۱۴ متر در ۱۴ متر در خط استوا) یا کوچک‌تر. کدهای پلاس می‌توانند به عنوان جایگزینی برای آدرس خیابان‌ها در مکان‌هایی که وجود ندارند (جایی که ساختمان‌ها شماره‌گذاری نشده‌اند یا خیابان‌ها نامگذاری نشده‌اند) استفاده شوند. به Open Location Code و کدهای پلاس مراجعه کنید. برای اطلاعات بیشتر به `PlusCode` مراجعه کنید.
`price_level`	اختیاری	شماره	سطح قیمت محل، در مقیاسی از ۰ تا ۴. مقدار دقیقی که با یک مقدار خاص نشان داده می‌شود، از منطقه‌ای به منطقه دیگر متفاوت خواهد بود. سطوح قیمت به شرح زیر تفسیر می‌شوند: 0 رایگان ۱ ارزان ۲ متوسط ۳ گران‌قیمت ۴ بسیار گران
`rating`	اختیاری	شماره	شامل امتیاز مکان، از ۱.۰ تا ۵.۰، بر اساس مجموع نظرات کاربران است.
`reference`	اختیاری	رشته	`reference` منسوخ شده است.
`reservable`	اختیاری	بولی	مشخص می‌کند که آیا مکان از رزرو پشتیبانی می‌کند یا خیر.
`reviews`	اختیاری	آرایه <PlaceReview>	یک آرایه JSON شامل حداکثر پنج نقد. به طور پیش‌فرض، نقدها به ترتیب اهمیت مرتب شده‌اند. از پارامتر درخواست `reviews_sort` برای کنترل مرتب‌سازی استفاده کنید. برای `most_relevant` (پیش‌فرض)، نقدها بر اساس میزان مرتبط بودن مرتب می‌شوند؛ این سرویس نتایج را طوری تنظیم می‌کند که نقدهایی را که در ابتدا به زبان دلخواه نوشته شده‌اند، برگرداند. برای `newest` ، نقدها به ترتیب زمانی مرتب می‌شوند؛ زبان مورد نظر تاثیری بر ترتیب مرتب‌سازی ندارد. گوگل توصیه می‌کند به کاربران نشان دهید که نتایج بر اساس `most_relevant` یا `newest` مرتب شده‌اند. برای اطلاعات بیشتر به PlaceReview مراجعه کنید.
`scope`	اختیاری	رشته	`scope` منسوخ شده است.
`secondary_opening_hours`	اختیاری	آرایه< ساعت‌های باز شدن مکان >	شامل آرایه‌ای از ورودی‌ها برای هفت روز آینده، شامل اطلاعات مربوط به ساعات کاری فرعی یک کسب‌وکار است. ساعات کاری فرعی با ساعات کاری اصلی یک کسب‌وکار متفاوت است. برای مثال، یک رستوران می‌تواند ساعات کاری درایو تو یا ساعات کاری تحویل را به عنوان ساعات کاری فرعی خود مشخص کند. این فیلد، زیرفیلد `type` را پر می‌کند که از یک لیست از پیش تعریف‌شده از انواع ساعات کاری (مانند `DRIVE_THROUGH` ، `PICKUP` یا `TAKEOUT` ) بر اساس انواع مکان استخراج می‌شود. این فیلد شامل زیرفیلد `special_days` مربوط به همه ساعات کاری است که برای تاریخ‌هایی با ساعات کاری استثنایی تنظیم شده است. برای اطلاعات بیشتر به PlaceOpeningHours مراجعه کنید.
`serves_beer`	اختیاری	بولی	مشخص می‌کند که آیا آن مکان آبجو سرو می‌کند یا خیر.
`serves_breakfast`	اختیاری	بولی	مشخص می‌کند که آیا آن مکان صبحانه سرو می‌کند یا خیر.
`serves_brunch`	اختیاری	بولی	مشخص می‌کند که آیا مکان مورد نظر برانچ سرو می‌کند یا خیر.
`serves_dinner`	اختیاری	بولی	مشخص می‌کند که آیا آن مکان شام سرو می‌کند یا خیر.
`serves_lunch`	اختیاری	بولی	مشخص می‌کند که آیا آن مکان ناهار سرو می‌کند یا خیر.
`serves_vegetarian_food`	اختیاری	بولی	مشخص می‌کند که آیا این مکان غذای گیاهی سرو می‌کند یا خیر.
`serves_wine`	اختیاری	بولی	مشخص می‌کند که آیا آن مکان شراب سرو می‌کند یا خیر.
`takeout`	اختیاری	بولی	مشخص می‌کند که آیا کسب‌وکار از بیرون‌بر پشتیبانی می‌کند یا خیر.
`types`	اختیاری	آرایه	شامل آرایه‌ای از انواع ویژگی‌ها است که نتیجه داده شده را توصیف می‌کنند. لیست انواع پشتیبانی شده را ببینید.
`url`	اختیاری	رشته	شامل آدرس اینترنتی (URL) صفحه رسمی گوگل برای این مکان است. این صفحه متعلق به گوگل خواهد بود که حاوی بهترین اطلاعات موجود در مورد مکان است. برنامه‌ها باید به این صفحه لینک دهند یا آن را در هر صفحه‌ای که نتایج دقیقی در مورد مکان به کاربر نشان می‌دهد، جاسازی کنند.
`user_ratings_total`	اختیاری	شماره	تعداد کل نظرات، با متن یا بدون متن، برای این مکان.
`utc_offset`	اختیاری	شماره	شامل تعداد دقایقی است که منطقه زمانی فعلی این مکان نسبت به UTC انحراف دارد. به عنوان مثال، برای مکان‌هایی در سیدنی، استرالیا در طول ساعت تابستانی، این مقدار ۶۶۰ (+۱۱ ساعت نسبت به UTC) و برای مکان‌هایی در کالیفرنیا خارج از ساعت تابستانی، این مقدار -۴۸۰ (-۸ ساعت نسبت به UTC) خواهد بود.
`vicinity`	اختیاری	رشته	فقط برای نتایج مربوط به مکان‌های اداری ( `types:["establishment", ...])` ، فیلد `vicinity` شامل آدرس ساده‌شده‌ای برای مکان، شامل نام خیابان، شماره خیابان و محل آن است، اما استان/ایالت، کد پستی یا کشور را شامل نمی‌شود. برای سایر نتایج، فیلد `vicinity` شامل نام محدودترین ویژگی سیاسی ( `types:["political", ...]` ) است که در آدرس نتیجه وجود دارد. این محتوا باید به همان شکلی که هست خوانده شود. آدرس فرمت شده را به صورت برنامه‌نویسی تجزیه نکنید.
`website`	اختیاری	رشته	وب‌سایت معتبر برای این مکان، مانند صفحه اصلی یک کسب‌وکار.
`wheelchair_accessible_entrance`	اختیاری	بولی	مشخص می‌کند که آیا مکان دارای ورودی با قابلیت دسترسی برای ویلچر است یا خیر.

خلاصه سرمقاله مکان

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

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

ساعات کاری مکان

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

میدان	مورد نیاز	نوع	توضیحات
`open_now`	اختیاری	بولی	یک مقدار بولی که نشان می‌دهد آیا مکان در زمان فعلی باز است یا خیر.
`periods`	اختیاری	آرایه < مکانبازساعتدوره >	مجموعه‌ای از دوره‌های افتتاحیه که هفت روز را پوشش می‌دهد و از یکشنبه شروع می‌شود، به ترتیب زمانی. برای اطلاعات بیشتر به PlaceOpeningHoursPeriod مراجعه کنید.
`special_days`	اختیاری	آرایه< روز خاص مکان >	آرایه‌ای از حداکثر هفت ورودی که مربوط به هفت روز آینده است. برای اطلاعات بیشتر به PlaceSpecialDay مراجعه کنید.
`type`	اختیاری	رشته	رشته‌ای از نوع که برای شناسایی نوع ساعات کاری ثانویه استفاده می‌شود (برای مثال، `DRIVE_THROUGH` ، `HAPPY_HOUR` ، `DELIVERY` ، `TAKEOUT` ، `KITCHEN` ، `BREAKFAST` ، `LUNCH` ، `DINNER` ، `BRUNCH` ، `PICKUP` ، `SENIOR_HOURS` ). فقط برای `secondary_opening_hours` تنظیم می‌شود.
`weekday_text`	اختیاری	آرایه	آرایه‌ای از رشته‌ها که ساعات کاری آن مکان را به صورت متن خوانا برای انسان توصیف می‌کند.

مکانساعات کاریدوره

میدان	مورد نیاز	نوع	توضیحات
`open`	مورد نیاز	مکانساعت کاریدورهجزئیات	شامل یک جفت شیء مربوط به روز و زمان است که زمان باز شدن مکان را توصیف می‌کنند. برای اطلاعات بیشتر به PlaceOpeningHoursPeriodDetail مراجعه کنید.
`close`	اختیاری	مکانساعت کاریدورهجزئیات	ممکن است شامل یک جفت شیء روز و زمان باشد که زمان بسته شدن مکان را توصیف می‌کنند. اگر مکانی همیشه باز باشد، بخش بسته شدن از پاسخ حذف خواهد شد. کلاینت‌ها می‌توانند به این اعتماد کنند که عبارت «همیشه باز» به عنوان یک دوره باز شامل روز با مقدار `0` و زمان با مقدار `0000` نمایش داده می‌شود و `close` وجود ندارد. برای اطلاعات بیشتر به PlaceOpeningHoursPeriodDetail مراجعه کنید.

روز ویژه مکان

میدان	مورد نیاز	نوع	توضیحات
`date`	اختیاری	رشته	تاریخی که با فرمت RFC3339 و در منطقه زمانی محلی برای آن مکان بیان شده است، برای مثال 2010-12-31.
`exceptional_hours`	اختیاری	بولی	اگر ساعات استثنایی برای این روز وجود داشته باشد، مقدار آن درست است. اگر `true` ، به این معنی است که حداقل یک استثنا برای این روز وجود دارد. استثناها باعث می‌شوند مقادیر متفاوتی در زیرفیلدهای `current_opening_hours` و `secondary_opening_hours` مانند `periods` ، `weekday_text` ، `open_now` رخ دهد. استثناها در مورد ساعات اعمال می‌شوند و از ساعات برای تولید فیلدهای دیگر استفاده می‌شود.

مکانساعت کاریدورهجزئیات

میدان	مورد نیاز	نوع	توضیحات
`day`	مورد نیاز	شماره	عددی از ۰ تا ۶، مربوط به روزهای هفته، که از یکشنبه شروع می‌شود. برای مثال، ۲ به معنی سه‌شنبه است.
`time`	مورد نیاز	رشته	ممکن است شامل یک زمان از روز با فرمت hhmm به صورت ۲۴ ساعته باشد. مقادیر در محدوده ۰۰۰۰ تا ۲۳۵۹ هستند. زمان بر اساس منطقه زمانی آن مکان گزارش خواهد شد.
`date`	اختیاری	رشته	تاریخی که با فرمت RFC3339 و در منطقه زمانی محلی برای آن مکان بیان شده است، برای مثال 2010-12-31.
`truncated`	اختیاری	بولی	اگر یک دوره معین به دلیل یک مهلت هفت روزه کوتاه شده باشد، صحیح است، که در آن دوره قبل از نیمه شب تاریخ درخواست شروع می‌شود و/یا در نیمه شب آخرین روز یا بعد از آن پایان می‌یابد. این ویژگی نشان می‌دهد که دوره باز یا بسته شدن می‌تواند پس از این مهلت هفت روزه ادامه یابد.

عکس مکان

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

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

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

میدان	مورد نیاز	نوع	توضیحات
`height`	مورد نیاز	شماره	ارتفاع عکس.
`html_attributions`	مورد نیاز	آرایه	ویژگی‌های HTML برای عکس.
`photo_reference`	مورد نیاز	رشته	رشته‌ای که برای شناسایی عکس هنگام انجام درخواست عکس استفاده می‌شود.
`width`	مورد نیاز	شماره	عرض عکس.

بررسی مکان

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

میدان	مورد نیاز	نوع	توضیحات
`author_name`	مورد نیاز	رشته	نام کاربری که نقد را ارسال کرده است. نقدهای ناشناس به "یک کاربر گوگل" نسبت داده می‌شوند.
`rating`	مورد نیاز	شماره	امتیاز کلی کاربر به این مکان. این یک عدد صحیح است که از ۱ تا ۵ متغیر است.
`relative_time_description`	مورد نیاز	رشته	زمانی که نقد به صورت متنی ارسال شده است، نسبت به زمان فعلی.
`time`	مورد نیاز	شماره	زمان ارسال بررسی، که بر حسب ثانیه از نیمه‌شب، ۱ ژانویه ۱۹۷۰ به وقت جهانی اندازه‌گیری می‌شود.
`author_url`	اختیاری	رشته	در صورت وجود، نشانی اینترنتی (URL) پروفایل راهنمایان محلی گوگل مپ کاربر.
`language`	اختیاری	رشته	یک کد زبان IETF که زبان نقد ارسالی را نشان می‌دهد. این فیلد فقط شامل برچسب اصلی زبان است و برچسب ثانویه که کشور یا منطقه را نشان می‌دهد، ندارد. برای مثال، تمام نقدهای انگلیسی با برچسب 'en' هستند و نه 'en-AU' یا 'en-UK' و غیره. اگر فقط یک امتیاز بدون متن نقد وجود داشته باشد، این فیلد خالی است.
`original_language`	اختیاری	رشته	یک کد زبان IETF که زبان اصلی نقد را نشان می‌دهد. اگر نقد ترجمه شده باشد، `original_language` != `language` . این فیلد فقط شامل برچسب زبان اصلی است و برچسب ثانویه که کشور یا منطقه را نشان می‌دهد را شامل نمی‌شود. برای مثال، همه نقدهای انگلیسی با برچسب 'en' هستند و نه 'en-AU' یا 'en-UK' و غیره. اگر فقط یک امتیاز بدون متن نقد وجود داشته باشد، این فیلد خالی است.
`profile_photo_url`	اختیاری	رشته	آدرس اینترنتی (URL) عکس پروفایل کاربر، در صورت وجود.
`text`	اختیاری	رشته	نقد کاربر. هنگام نقد یک مکان با Google Places، نقدهای متنی اختیاری در نظر گرفته می‌شوند. بنابراین، این فیلد ممکن است خالی باشد. توجه داشته باشید که این فیلد ممکن است شامل نشانه‌گذاری‌های اولیه HTML باشد. برای مثال، مرجع موجودیت `&` ممکن است نشان‌دهنده یک کاراکتر & باشد.
`translated`	اختیاری	بولی	یک مقدار بولی که نشان می‌دهد آیا نقد از زبان اصلی که به آن نوشته شده ترجمه شده است یا خیر. اگر نقدی ترجمه شده باشد، معادل مقدار true است، گوگل توصیه می‌کند که این موضوع را به کاربران خود اطلاع دهید. برای مثال، می‌توانید رشته زیر، "ترجمه شده توسط گوگل"، را به نقد اضافه کنید.

جزئیات مکان (قدمتی) با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

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

پارامترهای مورد نیاز

شناسه مکان

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

زمینه‌ها

زبان

منطقه

نقد و بررسی‌ها بدون ترجمه

بررسی‌ها_مرتب‌سازی

توکن جلسه

مثال جزئیات مکان (میراث)

پوسته

اچ‌تی‌پی

پاسخ جزئیات مکان (میراث)

جی‌سون

XML

جزئیات مکان‌هاپاسخ

html_attributions

result

status

info_messages

جزئیات مکان‌هاوضعیت

مکان

address_components

adr_address

business_status

curbside_pickup

current_opening_hours

delivery

dine_in

editorial_summary

formatted_address

formatted_phone_number

geometry

icon

icon_background_color

icon_mask_base_uri

international_phone_number

name

opening_hours

permanently_closed

photos

place_id

plus_code

price_level

rating

reference

reservable

reviews

scope

secondary_opening_hours

serves_beer

serves_breakfast

serves_brunch

serves_dinner

serves_lunch

serves_vegetarian_food

serves_wine

takeout

types

url

user_ratings_total

utc_offset

vicinity

website

wheelchair_accessible_entrance

خلاصه سرمقاله مکان

language

overview

ساعات کاری مکان

open_now

periods

special_days

type

weekday_text

مکانساعات کاریدوره

open

close

روز ویژه مکان

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

`html_attributions`

`result`

`status`

`info_messages`

`address_components`

`adr_address`

`business_status`

`curbside_pickup`

`current_opening_hours`

`delivery`

`dine_in`

`editorial_summary`

`formatted_address`

`formatted_phone_number`

`geometry`

`icon`

`icon_background_color`

`icon_mask_base_uri`

`international_phone_number`

`name`

`opening_hours`

`permanently_closed`

`photos`

`place_id`

`plus_code`

`price_level`

`rating`

`reference`

`reservable`

`reviews`

`scope`

`secondary_opening_hours`

`serves_beer`

`serves_breakfast`

`serves_brunch`

`serves_dinner`

`serves_lunch`

`serves_vegetarian_food`

`serves_wine`

`takeout`

`types`

`url`

`user_ratings_total`

`utc_offset`

`vicinity`

`website`

`wheelchair_accessible_entrance`

`language`

`overview`

`open_now`

`periods`

`special_days`

`type`

`weekday_text`

`open`

`close`

`date`

`exceptional_hours`

`day`

`time`

`date`

`truncated`

`height`

`html_attributions`

`photo_reference`

`width`

`author_name`

`rating`

`relative_time_description`

`time`

`author_url`

`language`

`original_language`

`profile_photo_url`

`text`

`translated`