این محصول در وضعیت قدیمی است. از اکتبر ۲۰۲۶، دیگر نمی‌توان Places API (قدیمی) را برای پروژه‌های جدید Google Cloud فعال کرد. پروژه‌های موجود همچنان به‌طور کامل پشتیبانی می‌شوند. برای ویژگی‌های جدید و عملکرد بهبودیافته، به Places API (جدید) نقل مکان کنید.

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

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

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

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

‫Places API با Java Client،‏ Python Client،‏ Go Client، و Node.js Client برای Google Maps Services نیز دردسترس است. Places API و کتابخانه‌های کارخواه برای استفاده در برنامه‌های سرور هستند.

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

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

درخواست‌های Place Details (Legacy)

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

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

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

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

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

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

place_id

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

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

فیلدها

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

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

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

پایه

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

تماس

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

محیط

دسته «جو» شامل فیلدهای زیر است: curbside_pickup، delivery، dine_in، editorial_summary، price_level، rating، reservable، reviews، serves_beer، serves_breakfast، serves_brunch، serves_dinner، serves_lunch، serves_vegetarian_food، serves_wine، takeout، user_ratings_total.

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

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

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

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

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

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

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

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

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

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

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

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

صدف

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

HTTP

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

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

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

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

(قالب) JSON

{
  "html_attributions": [],
  "result":
    {
      "address_components":
        [
          { "long_name": "48", "short_name": "48", "types": ["street_number"] },
          {
            "long_name": "Pirrama Road",
            "short_name": "Pirrama Rd",
            "types": ["route"],
          },
          {
            "long_name": "Pyrmont",
            "short_name": "Pyrmont",
            "types": ["locality", "political"],
          },
          {
            "long_name": "City of Sydney",
            "short_name": "City of Sydney",
            "types": ["administrative_area_level_2", "political"],
          },
          {
            "long_name": "New South Wales",
            "short_name": "NSW",
            "types": ["administrative_area_level_1", "political"],
          },
          {
            "long_name": "Australia",
            "short_name": "AU",
            "types": ["country", "political"],
          },
          {
            "long_name": "2009",
            "short_name": "2009",
            "types": ["postal_code"],
          },
        ],
      "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "business_status": "OPERATIONAL",
      "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "formatted_phone_number": "(02) 9374 4000",
      "geometry":
        {
          "location": { "lat": -33.866489, "lng": 151.1958561 },
          "viewport":
            {
              "northeast":
                { "lat": -33.8655112697085, "lng": 151.1971156302915 },
              "southwest":
                { "lat": -33.86820923029149, "lng": 151.1944176697085 },
            },
        },
      "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
      "icon_background_color": "#7B9EB0",
      "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
      "international_phone_number": "+61 2 9374 4000",
      "name": "Google Workplace 6",
      "opening_hours":
        {
          "open_now": false,
          "periods":
            [
              {
                "close": { "day": 1, "time": "1700" },
                "open": { "day": 1, "time": "0900" },
              },
              {
                "close": { "day": 2, "time": "1700" },
                "open": { "day": 2, "time": "0900" },
              },
              {
                "close": { "day": 3, "time": "1700" },
                "open": { "day": 3, "time": "0900" },
              },
              {
                "close": { "day": 4, "time": "1700" },
                "open": { "day": 4, "time": "0900" },
              },
              {
                "close": { "day": 5, "time": "1700" },
                "open": { "day": 5, "time": "0900" },
              },
            ],
          "weekday_text":
            [
              "Monday: 9:00 AM – 5:00 PM",
              "Tuesday: 9:00 AM – 5:00 PM",
              "Wednesday: 9:00 AM – 5:00 PM",
              "Thursday: 9:00 AM – 5:00 PM",
              "Friday: 9:00 AM – 5:00 PM",
              "Saturday: Closed",
              "Sunday: Closed",
            ],
        },
      "photos":
        [
          {
            "height": 3024,
            "html_attributions":
              [
                "Cynthia Wei",
              ],
            "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX",
            "width": 4032,
          },
          {
            "height": 3264,
            "html_attributions":
              [
                "Heyang Li",
              ],
            "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI",
            "width": 4912,
          },
          // ...
        ],
      "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,
          },
          // ...
        ],
      "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>
  <!-- ... -->
  <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>
  <!-- ... -->
  <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

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

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

PlacesDetailsStatus

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

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

جا

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

فیلد	الزامی	نوع	شرح
`address_components`	اختیاری	Array<`AddressComponent`>	آرایه‌ای حاوی مؤلفه‌های جداگانه قابل‌اعمال به این نشانی. برای اطلاعات بیشتر، به `AddressComponent` بروید.
`adr_address`	اختیاری	رشته	نمایشی از نشانی مکان در ریزقالب adr.
`business_status`	اختیاری	رشته	وضعیت عملیاتی مکان را نشان می‌دهد، اگر کسب‌وکار باشد. اگر داده‌ای وجود نداشته باشد، `business_status` برگردانده نمی‌شود. The allowed values include: `OPERATIONAL`, `CLOSED_TEMPORARILY`, and `CLOSED_PERMANENTLY`
`curbside_pickup`	اختیاری	بولی	مشخص می‌کند که آیا کسب‌وکار از تحویل گرفتن کالا در کنار پیاده‌رو پشتیبانی می‌کند یا نه.
`current_opening_hours`	اختیاری	PlaceOpeningHours	شامل ساعات کاری برای هفت روز آینده (ازجمله امروز) است. این دوره زمانی از نیمه‌شب تاریخ درخواست شروع می‌شود و ساعت ۱۱:۵۹ شب شش روز بعد به‌پایان می‌رسد. این فیلد شامل زیرفیلد `special_days` برای همه ساعت‌ها است که برای تاریخ‌هایی تنظیم شده است که ساعت کاری استثنایی دارند. برای اطلاعات بیشتر، به PlaceOpeningHours مراجعه کنید.
`delivery`	اختیاری	بولی	مشخص می‌کند که آیا کسب‌وکار از ارسال پشتیبانی می‌کند یا نه.
`dine_in`	اختیاری	بولی	مشخص می‌کند که آیا کسب‌وکار از گزینه‌های جای نشستن در فضای باز یا سرپوشیده پشتیبانی می‌کند یا نه.
`editorial_summary`	اختیاری	PlaceEditorialSummary	حاوی خلاصه‌ای از مکان است. خلاصه شامل یک نمای کلی متنی است و همچنین درصورت وجود، کد زبان این موارد را نیز دربرمی‌گیرد. نوشتار خلاصه باید همان‌طور که هست ارائه شود و نمی‌توان آن را اصلاح یا تغییر داد. برای اطلاعات بیشتر، PlaceEditorialSummary را ببینید.
`formatted_address`	اختیاری	رشته	رشته‌ای که حاوی نشانی قابل‌خواندن برای انسان از این مکان است. اغلب این نشانی معادل نشانی پستی است. توجه داشته باشید که برخی کشورها، مانند پادشاهی متحد (UK)، به‌دلیل محدودیت‌های صدور پروانه، اجازه توزیع نشانی‌های پستی واقعی را نمی‌دهند. نشانی قالب‌بندی‌شده به‌طور منطقی از یک یا چند مؤلفه نشانی تشکیل شده است. برای مثال، نشانی «111 8th Avenue, New York, NY» از بخش‌های زیر تشکیل شده است: «111» (شماره خیابان)، «8th Avenue» (مسیر)، «New York» (شهر)، و «NY» (ایالت آمریکا). نشانی قالب‌بندی‌شده را به‌صورت برنامه‌نویسی تجزیه نکنید. درعوض، باید از مؤلفه‌های نشانی فردی استفاده کنید که پاسخ میانای برنامه‌سازی کاربردی علاوه‌بر فیلد نشانی قالب‌بندی‌شده شامل آن می‌شود.
`formatted_phone_number`	اختیاری	رشته	حاوی شماره تلفن مکان در قالب محلی آن است.
`geometry`	اختیاری	`Geometry`	حاوی مکان و نمای مکان است. برای اطلاعات بیشتر، به `Geometry` بروید.
`icon`	اختیاری	رشته	حاوی نشانی وب نماد پیشنهادی است که ممکن است هنگام نشان دادن این نتیجه روی نقشه به کاربر نمایش داده شود.
`icon_background_color`	اختیاری	رشته	حاوی کد رنگ HEX پیش‌فرض برای دسته مکان است.
`icon_mask_base_uri`	اختیاری	رشته	حاوی نشانی وب نماد توصیه‌شده، منهای پسوند نوع فایل `.svg` یا `.png` است.
`international_phone_number`	اختیاری	رشته	حاوی شماره تلفن مکان در قالب بین‌المللی است. قالب بین‌المللی شامل کد کشور است و پیشوند آن علامت به‌علاوه (+) است. برای مثال، international_phone_number برای دفتر Google در سیدنی استرالیا `+61 2 9374 4000` است.
`name`	اختیاری	رشته	حاوی نام قابل‌خواندن برای انسان برای نتیجه برگردانده‌شده است. برای نتایج `establishment`، این معمولاً نام کسب‌وکار متعارف است.
`opening_hours`	اختیاری	PlaceOpeningHours	حاوی ساعت کاری معمول است. برای اطلاعات بیشتر، به PlaceOpeningHours مراجعه کنید.
`permanently_closed`	اختیاری	بولی	`permanently_closed` منسوخ شده است. از `business_status` برای دریافت وضعیت فعالیت کسب‌وکارها استفاده کنید.
`photos`	اختیاری	Array<PlacePhoto>	آرایه‌ای از اشیای عکس، که هرکدام حاوی ارجاعی به یک تصویر است. درخواست ممکن است تا ده عکس را برگرداند. اطلاعات بیشتر درباره عکس‌های مکان و نحوه استفاده از تصاویر در برنامه‌تان را می‌توانید در سند عکس‌های مکان پیدا کنید. برای اطلاعات بیشتر، PlacePhoto را ببینید.
`place_id`	اختیاری	رشته	شناسه نوشتاری که به‌طور منحصربه‌فرد مکانی را شناسایی می‌کند. برای بازیابی اطلاعات مربوط به مکان، این شناسه را در فیلد `place_id` درخواست Places API ارسال کنید. برای اطلاعات بیشتر درباره شناسه مکان، به نمای کلی شناسه مکان مراجعه کنید.
`plus_code`	اختیاری	`PlusCode`	مرجع مکان کدگذاری‌شده، برگرفته از مختصات عرض جغرافیایی و طول جغرافیایی، که نشان‌دهنده یک منطقه است: ۱/۸۰۰۰ درجه در ۱/۸۰۰۰ درجه (حدود ۱۴ متر در ۱۴ متر در خط استوا) یا کوچک‌تر. کدهای Plus را می‌توان به‌عنوان جایگزینی برای نشانی خیابان در مکان‌هایی که نشانی خیابان وجود ندارد (جایی که ساختمان‌ها شماره‌گذاری نشده‌اند یا خیابان‌ها نام‌گذاری نشده‌اند) استفاده کرد. کد مکان باز و کدهای باز را ببینید. برای اطلاعات بیشتر، به `PlusCode` بروید.
`price_level`	اختیاری	شماره	سطح قیمت مکان، در مقیاس ۰ تا ۴. مقدار دقیق نشان‌داده‌شده با یک مقدار خاص از منطقه‌ای به منطقه دیگر متفاوت خواهد بود. سطوح قیمت به‌صورت زیر تفسیر می‌شود: ۰ رایگان ‫۱ ارزان ‫۲ متوسط ‫۳ گران ‫۴ بسیار گران
`rating`	اختیاری	شماره	حاوی رده‌بندی مکان، از ۱٫۰ تا ۵٫۰، براساس مرورهای انبوهیده کاربر است.
`reference`	اختیاری	رشته	`reference` منسوخ شده است.
`reservable`	اختیاری	بولی	مشخص می‌کند که آیا مکان از رزرو پشتیبانی می‌کند یا نه.
`reviews`	اختیاری	Array<PlaceReview>	آرایه JSON با حداکثر پنج مرور. به‌طور پیش‌فرض، مرورها براساس میزان مربوط بودن مرتب می‌شوند. از پارامتر درخواست `reviews_sort` برای کنترل مرتب‌سازی استفاده کنید. برای `most_relevant` (پیش‌فرض)، مرورها براساس میزان مربوط بودن مرتب می‌شوند؛ سرویس نتایج را به‌سمت برگرداندن مرورهایی که دراصل به زبان ترجیحی نوشته شده‌اند متمایل می‌کند. برای `newest`، مرورها به‌ترتیب زمانی مرتب شده‌اند؛ زبان ترجیحی بر ترتیب مرتب‌سازی تأثیری ندارد. Google توصیه می‌کند به کاربران نشان دهید که نتایج براساس `most_relevant` یا `newest` مرتب شده‌اند. برای اطلاعات بیشتر، PlaceReview را ببینید.
`scope`	اختیاری	رشته	`scope` منسوخ شده است.
`secondary_opening_hours`	اختیاری	Array<PlaceOpeningHours>	حاوی آرایه‌ای از ورودی‌ها برای هفت روز آینده است، ازجمله اطلاعاتی درباره ساعت کاری فرعی کسب‌وکار. ساعت کاری ثانویه با ساعت کاری اصلی کسب‌وکار متفاوت است. برای نمونه، رستوران می‌تواند ساعت‌های بگیر و بران یا ساعت‌های ارسال را به‌عنوان ساعت‌های ثانویه خود مشخص کند. این فیلد زیرفیلد `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`	اختیاری	Array<string>	حاوی آرایه‌ای از انواع ویژگی است که نتیجه ارائه‌شده را توصیف می‌کند. فهرست انواع پشتیبانی‌شده را ببینید.
`url`	اختیاری	رشته	حاوی نشانی وب صفحه رسمی Google برای این مکان است. این صفحه متعلق به Google خواهد بود که حاوی بهترین اطلاعات موجود درباره آن مکان است. برنامه‌ها باید در هر صفحه‌ای که نتایج دقیق درباره مکان را به کاربر نشان می‌دهد، به این صفحه پیوند دهند یا آن را جاسازی کنند.
`user_ratings_total`	اختیاری	شماره	تعداد کل مرورها، با یا بدون نوشتار، برای این مکان.
`utc_offset`	اختیاری	شماره	حاوی تعداد دقیقه‌هایی است که منطقه زمانی فعلی این مکان از ساعت هماهنگ جهانی (UTC) انحراف دارد. برای مثال، برای مکان‌هایی در سیدنی، استرالیا درطول ساعت تابستانی، این مقدار ۶۶۰ (۱۱+ ساعت از UTC) خواهد بود، و برای مکان‌هایی در کالیفرنیا خارج از ساعت تابستانی، این مقدار ‎-۴۸۰ (۸- ساعت از UTC) خواهد بود.
`vicinity`	اختیاری	رشته	برای نتایج مؤسسه (`types:["establishment", ...])` فقط، فیلد `vicinity` حاوی نشانی ساده‌شده‌ای برای مکان است، ازجمله نام خیابان، شماره خیابان، و منطقه، اما استان/ایالت، کد پستی، یا کشور را شامل نمی‌شود. برای همه نتایج دیگر، فیلد `vicinity` حاوی نام محدودترین ویژگی سیاسی (`types:["political", ...]`) است که در نشانی نتیجه وجود دارد. این محتوا باید همان‌طور که هست خوانده شود. نشانی قالب‌بندی‌شده را به‌صورت برنامه‌نویسی‌شده تجزیه نکنید.
`website`	اختیاری	رشته	وب‌سایت رسمی این مکان، مثل صفحه اصلی کسب‌وکار.
`wheelchair_accessible_entrance`	اختیاری	بولی	مشخص می‌کند که آیا مکان ورودی‌ای دارد که برای صندلی چرخدار دسترس‌پذیر باشد.

PlaceEditorialSummary

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

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

PlaceOpeningHours

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

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

PlaceOpeningHoursPeriod

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

PlaceSpecialDay

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

PlaceOpeningHoursPeriodDetail

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

PlacePhoto

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

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

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

فیلد	الزامی	نوع	شرح
`height`	الزامی	شماره	ارتفاع عکس.
`html_attributions`	الزامی	Array<string>	ارجاع‌های HTML برای عکس.
`photo_reference`	الزامی	رشته	رشته‌ای که برای شناسایی عکس هنگام درخواست «عکس» استفاده می‌شود.
`width`	الزامی	شماره	عرض عکس.

PlaceReview

مروری از مکان که کاربری ارسال کرده است.

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

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

درخواست‌های Place Details (Legacy)

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

place_id

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

فیلدها

زبان

منطقه

reviews_no_translations

reviews_sort

sessiontoken

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

صدف

HTTP

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

(قالب) JSON

XML

PlacesDetailsResponse

html_attributions

result

status

info_messages

PlacesDetailsStatus

جا

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

PlaceEditorialSummary

language

overview

PlaceOpeningHours

open_now

periods

special_days

type

weekday_text

PlaceOpeningHoursPeriod

open

close

PlaceSpecialDay

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

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