این محصول یا ویژگی در وضعیت 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 به دست آوردید، می‌توانید با شروع درخواست Place Details (Legacy) جزئیات بیشتری در مورد یک مکان یا نقطه مورد علاقه خاص درخواست کنید. درخواست Place Details (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_id درخواست می‌کند و فیلدهای name ، rating و formatted_phone_number را نیز شامل می‌شود:

آدرس اینترنتی

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

حلقه

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'

توجه داشته باشید که برای اینکه درخواست در برنامه شما کار کند، باید کلید موجود در این مثال را با کلید 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": '<span class="street-address">48 Pirrama Rd</span>, <span class="locality">Pyrmont</span> <span class="region">NSW</span> <span class="postal-code">2009</span>, <span class="country-name">Australia</span>',
      "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":
              [
                '<a href="https://maps.google.com/maps/contrib/117600448889234589608">Cynthia Wei</a>',
              ],
            "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX",
            "width": 4032,
          },
          {
            "height": 3264,
            "html_attributions":
              [
                '<a href="https://maps.google.com/maps/contrib/102493344958625549078">Heyang Li</a>',
              ],
            "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI",
            "width": 4912,
          },
          {
            "height": 3036,
            "html_attributions":
              [
                '<a href="https://maps.google.com/maps/contrib/104829437842034782235">Anna Linetsky</a>',
              ],
            "photo_reference": "Aap_uEAumTzSdhRHDutPAj6wVPSZZmBV-brI6TPFwI0tcQlbSR74z44mUPr4aXMQKck_AzHaKmbfR3P2c1qsu45i1RQPHrcpIXxrA78FmDjCdWYYZWUnFozdcmEj9OQ_V0G08adpKivMKZyeaQ1NuwRy9GhSopeKpzkzkFZG5vXMYPPSgpa1",
            "width": 4048,
          },
          {
            "height": 4016,
            "html_attributions":
              [
                '<a href="https://maps.google.com/maps/contrib/107755640736541028674">Jonah Dell</a>',
              ],
            "photo_reference": "Aap_uECC7cSbDkh-TdmXr6m5d5pgVXJmvXg8dF2jzhL0b0Ko4CtnVll6-tIvdz7vhbCsd3hl2u9EgZ4Y30FBxKmFcimfeYUgW2XJyv8JY5IYGuXsKkCLqpV3QH9dIGwoUv2uX0eosDsUsTN2DOlyOasUgVxcYqzIzEmrL5ofIssThQWZeozD",
            "width": 6016,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                '<a href="https://maps.google.com/maps/contrib/115886271727815775491">Anthony Huynh</a>',
              ],
            "photo_reference": "Aap_uEDTdw58CglFmZZAR9iZ05x3y2oK9r5_dRqKWnbZKSS9gs6gp9AeBa1QDvBL6dzZyQAZfN8H2Eppu6y4NBaPOp-GkulZYiKRM7Yww8sUEv-8dmcq35Tx38pe4LEX2wIicFkQHedRgMc0FfV9aFtgosQ5ps5-HCjJSApg8eLGyuxxqPm9",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                '<a href="https://maps.google.com/maps/contrib/102939237947063969663">Jasen Baker</a>',
              ],
            "photo_reference": "Aap_uEAGqslqZPhZUk0T2Y6l7mkCYnY7JN9li4g5NkZsE0N4Cdy7_cZ-fZWyV02VhpQR4Ph4fLUL6_WTXrlGMXXzUJXUcSmSTs2d_Dzf3Q_A1y07Dm-vtv7pS3JXsWyrWETGIoT1pIj81PPdUc1vlR2i3GFMWAbx9rCC472ZJclY8JlvMg-x",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                '<a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a>',
              ],
            "photo_reference": "Aap_uEBaGxeN90YFjD-AUjxZqM44kpMcICKKBBhb0RQQS7DHHFaay8RRAwjWsAt8GEmmB5QnxrbQWHU3TwhVXXHP0m-YNp9Ds3ihpiFan0moNv4QB7kern5cfjWhhrWe8B0dz_vYvmPssJE24P-24YfWWHubOo0L2MjQyueZfDv57N_RvDZk",
            "width": 4032,
          },
          {
            "height": 1515,
            "html_attributions":
              [
                '<a href="https://maps.google.com/maps/contrib/112343109286948028063">Andrew W</a>',
              ],
            "photo_reference": "Aap_uEBDzJlmTeNUreMop6_hkC1HKTCRLyPs5fikJi58qCejtkWp5PIM6vzNN3HErkSWUwnamTr_WLyT7jXMAIdByR-hx8dG-OHjj5JxzmcPvuT_VeVLmdSbNPeIlpmp6EUcPOhaVrhEKojSd44QXkl0za29eZ0oj1KDOnAsGxmhanDFW7lI",
            "width": 2048,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                '<a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a>',
              ],
            "photo_reference": "Aap_uEBvYFpzCDQzvQ0kdBxxB70lTkLbTM0yH3xF-BCHsb7DQ63cuWnutvwv8oVLDSbA14_kns3WVlEInTyy2elvmH5lzQteb6zzRu3exkwE65_55TgJqdLO7RYYiPFliWk4ocszn9nn5ELv5uP2BQmqr9QET5vwgxR-0eshyVmcdM42jb39",
            "width": 4032,
          },
          {
            "height": 4032,
            "html_attributions":
              [
                '<a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a>',
              ],
            "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": "Called regarding paid advertising google pages to the top of its site of a scam furniture website misleading and taking peoples money without ever sending a product - explained the situation,  explained I'd spoken to an ombudsman regarding it.  Listed ticket numbers etc.\n\nThey left the advertisement running.",
            "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": "I need help.  Google Australia is taking my money. Money I don't have any I am having trouble sorting this issue out",
            "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": "I have literally never been here in my life, I am 17 and they are taking money I don't have for no reason.\n\nThis is not ok. I have rent to pay and my own expenses to deal with and now this.",
            "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": "Terrible service. all reviews are fake and irrelevant. This is about reviewing google as business not the building/staff etc.",
            "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": "Nice site. Please I want to work with you. Am Alhassan Haruna, from Ghana. Contact me +233553851616",
            "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

<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>Called regarding paid advertising google pages to the top of its site of a scam furniture website misleading and taking peoples money without ever sending a product - explained the situation,  explained I'd spoken to an ombudsman regarding it.  Listed ticket numbers etc.
They left the advertisement running.</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>I need help.  Google Australia is taking my money. Money I don't have any I am having trouble sorting this issue out</text>
   <author_name>Tevita Taufoou</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>I have literally never been here in my life, I am 17 and they are taking money I don't have for no reason.
This is not ok. I have rent to pay and my own expenses to deal with and now this.</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>Terrible service. all reviews are fake and irrelevant. This is about reviewing google as business not the building/staff etc.</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>Nice site. Please I want to work with you. Am Alhassan Haruna, from Ghana. Contact me +233553851616</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

Field	Required	Type	Description
`html_attributions`	required	Array<string>	May contain a set of attributions about this listing which must be displayed to the user (some listings may not have attribution).
`result`	required	Place	Contains the detailed information about the place requested. See Place for more information.
`status`	required	PlacesDetailsStatus	Contains the status of the request, and may contain debugging information to help you track down why the request failed. See PlacesDetailsStatus for more information.
`info_messages`	optional	Array<string>	When the service returns additional information about the request specification, there may be an additional `info_messages` field within the response object. This field is only returned for successful requests. It may not always be returned, and its content is subject to change.

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

PlacesDetailsStatus

Status codes returned by service.

OK indicating the API request was successful.
ZERO_RESULTS indicating that the referenced location, place_id , was valid but no longer refers to a valid result. This may occur if the establishment is no longer in business.
NOT_FOUND indicating that that the referenced location, place_id , was not found in the Places database.
INVALID_REQUEST indicating the API request was malformed.
OVER_QUERY_LIMIT indicating any of the following:
- You have exceeded the QPS limits.
- Billing has not been enabled on your account.
- The monthly $200 credit, or a self-imposed usage cap, has been exceeded.
- The provided method of payment is no longer valid (for example, a credit card has expired).
See the Maps FAQ for more information about how to resolve this error.
REQUEST_DENIED indicating that your request was denied, generally because:
- The request is missing an API key.
- The key parameter is invalid.
UNKNOWN_ERROR indicating an unknown error.

Place

Attributes describing a place. Not all attributes will be available for all place types.

Field	Required	Type	Description
`address_components`	optional	Array< AddressComponent >	An array containing the separate components applicable to this address. See AddressComponent for more information.
`adr_address`	optional	string	A representation of the place's address in the adr microformat .
`business_status`	optional	string	Indicates the operational status of the place, if it is a business. If no data exists, `business_status` is not returned. The allowed values include: `OPERATIONAL` , `CLOSED_TEMPORARILY` , and `CLOSED_PERMANENTLY`
`curbside_pickup`	optional	boolean	Specifies if the business supports curbside pickup.
`current_opening_hours`	optional	PlaceOpeningHours	Contains the hours of operation for the next seven days (including today). The time period starts at midnight on the date of the request and ends at 11:59 pm six days later. This field includes the `special_days` subfield of all hours, set for dates that have exceptional hours. See PlaceOpeningHours for more information.
`delivery`	optional	boolean	Specifies if the business supports delivery.
`dine_in`	optional	boolean	Specifies if the business supports indoor or outdoor seating options.
`editorial_summary`	optional	PlaceEditorialSummary	Contains a summary of the place. A summary is comprised of a textual overview, and also includes the language code for these if applicable. Summary text must be presented as-is and can not be modified or altered. See PlaceEditorialSummary for more information.
`formatted_address`	optional	string	A string containing the human-readable address of this place. Often this address is equivalent to the postal address. Note that some countries, such as the United Kingdom, do not allow distribution of true postal addresses due to licensing restrictions. The formatted address is logically composed of one or more address components. For example, the address "111 8th Avenue, New York, NY" consists of the following components: "111" (the street number), "8th Avenue" (the route), "New York" (the city) and "NY" (the US state). Do not parse the formatted address programmatically. Instead you should use the individual address components, which the API response includes in addition to the formatted address field.
`formatted_phone_number`	optional	string	Contains the place's phone number in its local format .
`geometry`	optional	Geometry	Contains the location and viewport for the location. See Geometry for more information.
`icon`	optional	string	Contains the URL of a suggested icon which may be displayed to the user when indicating this result on a map.
`icon_background_color`	optional	string	Contains the default HEX color code for the place's category.
`icon_mask_base_uri`	optional	string	Contains the URL of a recommended icon, minus the `.svg` or `.png` file type extension.
`international_phone_number`	optional	string	Contains the place's phone number in international format. International format includes the country code, and is prefixed with the plus, +, sign. For example, the international_phone_number for Google's Sydney, Australia office is `+61 2 9374 4000` .
`name`	optional	string	Contains the human-readable name for the returned result. For `establishment` results, this is usually the canonicalized business name.
`opening_hours`	optional	PlaceOpeningHours	Contains the regular hours of operation. See PlaceOpeningHours for more information.
`permanently_closed`	optional	boolean	`permanently_closed` is deprecated. Use `business_status` to get the operational status of businesses.
`photos`	optional	Array< PlacePhoto >	An array of photo objects, each containing a reference to an image. A request may return up to ten photos. More information about place photos and how you can use the images in your application can be found in the Place Photos documentation. See PlacePhoto for more information.
`place_id`	optional	string	A textual identifier that uniquely identifies a place. To retrieve information about the place, pass this identifier in the `place_id` field of a Places API request. For more information about place IDs, see the place ID overview .
`plus_code`	optional	PlusCode	An encoded location reference, derived from latitude and longitude coordinates, that represents an area: 1/8000th of a degree by 1/8000th of a degree (about 14m x 14m at the equator) or smaller. Plus codes can be used as a replacement for street addresses in places where they do not exist (where buildings are not numbered or streets are not named). See Open Location Code and plus codes . See PlusCode for more information.
`price_level`	optional	number	The price level of the place, on a scale of 0 to 4. The exact amount indicated by a specific value will vary from region to region. Price levels are interpreted as follows: 0 Free 1 Inexpensive 2 Moderate 3 Expensive 4 Very Expensive
`rating`	optional	number	Contains the place's rating, from 1.0 to 5.0, based on aggregated user reviews.
`reference`	optional	string	`reference` is deprecated.
`reservable`	optional	boolean	Specifies if the place supports reservations.
`reviews`	optional	Array< PlaceReview >	A JSON array of up to five reviews. By default, the reviews are sorted in order of relevance. Use the `reviews_sort` request parameter to control sorting. For `most_relevant` (default), reviews are sorted by relevance; the service will bias the results to return reviews originally written in the preferred language. For `newest` , reviews are sorted in chronological order; the preferred language does not affect the sort order. Google recommends indicating to users whether results are ordered by `most_relevant` or `newest` . See PlaceReview for more information.
`scope`	optional	string	`scope` is deprecated.
`secondary_opening_hours`	optional	Array< PlaceOpeningHours >	Contains an array of entries for the next seven days including information about secondary hours of a business. Secondary hours are different from a business's main hours. For example, a restaurant can specify drive through hours or delivery hours as its secondary hours. This field populates the `type` subfield, which draws from a predefined list of opening hours types (such as `DRIVE_THROUGH` , `PICKUP` , or `TAKEOUT` ) based on the types of the place. This field includes the `special_days` subfield of all hours, set for dates that have exceptional hours. See PlaceOpeningHours for more information.
`serves_beer`	optional	boolean	Specifies if the place serves beer.
`serves_breakfast`	optional	boolean	Specifies if the place serves breakfast.
`serves_brunch`	optional	boolean	Specifies if the place serves brunch.
`serves_dinner`	optional	boolean	Specifies if the place serves dinner.
`serves_lunch`	optional	boolean	Specifies if the place serves lunch.
`serves_vegetarian_food`	optional	boolean	Specifies if the place serves vegetarian food.
`serves_wine`	optional	boolean	Specifies if the place serves wine.
`takeout`	optional	boolean	Specifies if the business supports takeout.
`types`	optional	Array<string>	Contains an array of feature types describing the given result. See the list of supported types .
`url`	optional	string	Contains the URL of the official Google page for this place. This will be the Google-owned page that contains the best available information about the place. Applications must link to or embed this page on any screen that shows detailed results about the place to the user.
`user_ratings_total`	optional	number	The total number of reviews, with or without text, for this place.
`utc_offset`	optional	number	Contains the number of minutes this place’s current timezone is offset from UTC. For example, for places in Sydney, Australia during daylight saving time this would be 660 (+11 hours from UTC), and for places in California outside of daylight saving time this would be -480 (-8 hours from UTC).
`vicinity`	optional	string	For establishment ( `types:["establishment", ...])` results only, the `vicinity` field contains a simplified address for the place, including the street name, street number, and locality, but not the province/state, postal code, or country. For all other results, the `vicinity` field contains the name of the narrowest political ( `types:["political", ...]` ) feature that is present in the address of the result. This content is meant to be read as-is. Do not programmatically parse the formatted address.
`website`	optional	string	The authoritative website for this place, such as a business' homepage.
`wheelchair_accessible_entrance`	optional	boolean	Specifies if the place has an entrance that is wheelchair-accessible.

AddressComponent

Field	Required	Type	Description
`long_name`	required	string	The full text description or name of the address component as returned by the Geocoder.
`short_name`	required	string	An abbreviated textual name for the address component, if available. For example, an address component for the state of Alaska may have a long_name of "Alaska" and a short_name of "AK" using the 2-letter postal abbreviation.
`types`	required	Array<string>	An array indicating the type of the address component. See the list of supported types .

PlaceEditorialSummary

Contains a summary of the place. A summary is comprised of a textual overview, and also includes the language code for these if applicable. Summary text must be presented as-is and can not be modified or altered.

Field	Required	Type	Description
`language`	optional	string	The language of the previous fields. May not always be present.
`overview`	optional	string	A medium-length textual summary of the place.

Geometry

An object describing the location.

Field	Required	Type	Description
`location`	required	LatLngLiteral	See LatLngLiteral for more information.
`viewport`	required	Bounds	See Bounds for more information.

LatLngLiteral

An object describing a specific location with Latitude and Longitude in decimal degrees.

Field	Required	Type	Description
`lat`	required	number	Latitude in decimal degrees
`lng`	required	number	Longitude in decimal degrees

Bounds

A rectangle in geographical coordinates from points at the southwest and northeast corners.

Field	Required	Type	Description
`northeast`	required	LatLngLiteral	See LatLngLiteral for more information.
`southwest`	required	LatLngLiteral	See LatLngLiteral for more information.

PlaceOpeningHours

An object describing the opening hours of a place.

Field	Required	Type	Description
`open_now`	optional	boolean	A boolean value indicating if the place is open at the current time.
`periods`	optional	Array< PlaceOpeningHoursPeriod >	An array of opening periods covering seven days, starting from Sunday, in chronological order. See PlaceOpeningHoursPeriod for more information.
`special_days`	optional	Array< PlaceSpecialDay >	An array of up to seven entries corresponding to the next seven days. See PlaceSpecialDay for more information.
`type`	optional	string	A type string used to identify the type of secondary hours (for example, `DRIVE_THROUGH` , `HAPPY_HOUR` , `DELIVERY` , `TAKEOUT` , `KITCHEN` , `BREAKFAST` , `LUNCH` , `DINNER` , `BRUNCH` , `PICKUP` , `SENIOR_HOURS` ). Set for `secondary_opening_hours` only.
`weekday_text`	optional	Array<string>	An array of strings describing in human-readable text the hours of the place.

PlaceOpeningHoursPeriod

Field	Required	Type	Description
`open`	required	PlaceOpeningHoursPeriodDetail	Contains a pair of day and time objects describing when the place opens. See PlaceOpeningHoursPeriodDetail for more information.
`close`	optional	PlaceOpeningHoursPeriodDetail	May contain a pair of day and time objects describing when the place closes. If a place is always open, the close section will be missing from the response. Clients can rely on always-open being represented as an open period containing day with value `0` and time with value `0000` , and no `close` . See PlaceOpeningHoursPeriodDetail for more information.

PlaceSpecialDay

Field	Required	Type	Description
`date`	optional	string	A date expressed in RFC3339 format in the local timezone for the place, for example 2010-12-31.
`exceptional_hours`	optional	boolean	True if there are exceptional hours for this day. If `true` , this means that there is at least one exception for this day. Exceptions cause different values to occur in the subfields of `current_opening_hours` and `secondary_opening_hours` such as `periods` , `weekday_text` , `open_now` . The exceptions apply to the hours, and the hours are used to generate the other fields.

PlaceOpeningHoursPeriodDetail

Field	Required	Type	Description
`day`	required	number	A number from 0–6, corresponding to the days of the week, starting on Sunday. For example, 2 means Tuesday.
`time`	required	string	May contain a time of day in 24-hour hhmm format. Values are in the range 0000–2359. The time will be reported in the place’s time zone.
`date`	optional	string	A date expressed in RFC3339 format in the local timezone for the place, for example 2010-12-31.
`truncated`	optional	boolean	True if a given period was truncated due to a seven-day cutoff, where the period starts before midnight on the date of the request and/or ends at or after midnight on the last day. This property indicates that the period for open or close can extend past this seven-day cutoff.

PlacePhoto

A photo of a Place. The photo can be accesed via the Place Photo API using an url in the following pattern:

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

See Place Photos for more information.

Field	Required	Type	Description
`height`	required	number	The height of the photo.
`html_attributions`	required	Array<string>	The HTML attributions for the photo.
`photo_reference`	required	string	A string used to identify the photo when you perform a Photo request.
`width`	required	number	The width of the photo.

PlusCode

An encoded location reference, derived from latitude and longitude coordinates, that represents an area, 1/8000th of a degree by 1/8000th of a degree (about 14m x 14m at the equator) or smaller. Plus codes can be used as a replacement for street addresses in places where they do not exist (where buildings are not numbered or streets are not named).

Field	Required	Type	Description
`global_code`	required	string	The `global_code` is a 4 character area code and 6 character or longer local code ( `849VCWC8+R9` ).
`compound_code`	optional	string	The `compound_code` is a 6 character or longer local code with an explicit location ( `CWC8+R9, Mountain View, CA, USA` ). Some APIs may return an empty string if the `compound_code` is not available.

PlaceReview

A review of the place submitted by a user.

Field	Required	Type	Description
`author_name`	required	string	The name of the user who submitted the review. Anonymous reviews are attributed to "A Google user".
`rating`	required	number	The user's overall rating for this place. This is a whole number, ranging from 1 to 5.
`relative_time_description`	required	string	The time that the review was submitted in text, relative to the current time.
`time`	required	number	The time that the review was submitted, measured in the number of seconds since since midnight, January 1, 1970 UTC.
`author_url`	optional	string	The URL to the user's Google Maps Local Guides profile, if available.
`language`	optional	string	An IETF language code indicating the language of the returned review.This field contains the main language tag only, and not the secondary tag indicating country or region. For example, all the English reviews are tagged as 'en', and not 'en-AU' or 'en-UK' and so on.This field is empty if there is only a rating with no review text.
`original_language`	optional	string	An IETF language code indicating the original language of the review. If the review has been translated, then `original_language` != `language` .This field contains the main language tag only, and not the secondary tag indicating country or region. For example, all the English reviews are tagged as 'en', and not 'en-AU' or 'en-UK' and so on.This field is empty if there is only a rating with no review text.
`profile_photo_url`	optional	string	The URL to the user's profile photo, if available.
`text`	optional	string	The user's review. When reviewing a location with Google Places, text reviews are considered optional. Therefore, this field may be empty. Note that this field may include simple HTML markup. For example, the entity reference `&` may represent an ampersand character.
`translated`	optional	boolean	A boolean value indicating if the review was translated from the original language it was written in.If a review has been translated, corresponding to a value of true, Google recommends that you indicate this to your users. For example, you can add the following string, “Translated by Google”, to the review.

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

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

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

شناسه مکان

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

زمینه‌ها

زبان

منطقه

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

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

توکن جلسه

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

آدرس اینترنتی

حلقه

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

جی‌سون

XML

PlacesDetailsResponse

html_attributions

result

status

info_messages

PlacesDetailsStatus

Place

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

AddressComponent

long_name

short_name

types

PlaceEditorialSummary

language

overview

Geometry

location

viewport

LatLngLiteral

lat

lng

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

`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`

`long_name`

`short_name`

`types`

`language`

`overview`

`location`

`viewport`

`lat`

`lng`

`northeast`

`southwest`

`open_now`

`periods`

`special_days`

`type`

`weekday_text`

`open`

`close`

`date`

`exceptional_hours`

`day`

`time`

`date`

`truncated`

`height`

`html_attributions`

`photo_reference`

`width`

`global_code`

`compound_code`

`author_name`

`rating`