هذا المنتج أو هذه الميزة في حالة "قديم". لمزيد من المعلومات عن الحالة "قديمة"، يُرجى الاطّلاع على المنتجات والميزات القديمة. لنقل البيانات إلى Places API (الإصدار الجديد)، يُرجى الاطّلاع على دليل نقل البيانات.

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

تفاصيل المكان (الإصدار القديم)

المطوّرون في المنطقة الاقتصادية الأوروبية

ملاحظة: مكتبات من جهة الخادم ومن جهة العميل

تتوفّر Places API أيضًا مع برنامج Java وبرنامج Python وبرنامج Go وبرنامج Node.js لخدمات "خرائط Google". إنّ Places API ومكتبات البرامج مخصّصة للاستخدام في تطبيقات الخادم.

إذا كنت بصدد إنشاء تطبيق من جهة العميل، يمكنك الاطّلاع على Places SDK لنظام التشغيل Android (إصدار جديد) وPlaces SDK لنظام التشغيل iOS (إصدار جديد) ومكتبة الأماكن في Maps JavaScript API.

بعد الحصول على place_id من عملية بحث عن مكان، يمكنك طلب المزيد من التفاصيل حول مؤسسة معيّنة أو نقطة اهتمام معيّنة من خلال بدء طلب "تفاصيل المكان" (الإصدار القديم). يعرض طلب "تفاصيل المكان (الإصدار القديم)" معلومات أكثر شمولاً عن المكان المحدّد، مثل العنوان الكامل ورقم الهاتف وتقييمات المستخدمين ومراجعاتهم.

طلبات "تفاصيل المكان" (الإصدار القديم)

طلب "تفاصيل المكان (الإصدار القديم)" هو عنوان URL بتنسيق HTTP على النحو التالي:

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

حيث يمكن أن تكون output إحدى القيمتين التاليتين:

يشير json (يُنصح به) إلى الإخراج بتنسيق كائن JavaScript Notation (JSON)
يشير xml إلى الناتج بتنسيق XML

يجب توفّر مَعلمات معيّنة لبدء طلب بحث. وكما هو معتاد في عناوين URL، يتم الفصل بين جميع المَعلمات باستخدام رمز العطف (&). في ما يلي قائمة بالمعلمات وقيمها المحتملة.

المعلمات المطلوبة

place_id

معرّف نصي يحدّد مكانًا بشكل فريد، ويتم عرضه من خلال البحث عن الأماكن (الإصدار القديم). لمزيد من المعلومات حول معرّفات الأماكن، راجِع نظرة عامة على معرّفات الأماكن.

المعلمات الاختيارية

fields

تنبيه: لا تعرض طلبات البحث عن الأماكن (الإصدار القديم) وطلبات تفاصيل المكان (الإصدار القديم) الحقول نفسها. تعرض طلبات البحث عن الأماكن (الإصدار القديم) مجموعة فرعية من الحقول التي تعرضها طلبات تفاصيل المكان (الإصدار القديم). إذا لم يعرض البحث عن الأماكن (Legacy) الحقل الذي تريده، يمكنك استخدام البحث عن الأماكن (Legacy) للحصول على place_id، ثم استخدام رقم تعريف المكان هذا لإجراء طلب تفاصيل المكان (Legacy). لمزيد من المعلومات عن الحقول غير المتوفّرة في طلب البحث عن الأماكن (الإصدار القديم)، يُرجى الاطّلاع على حقول بيانات الأماكن (الإصدار القديم).

استخدِم المَعلمة fields لتحديد قائمة قيم مفصولة بفاصلة لأنواع بيانات الأماكن المطلوب عرضها. على سبيل المثال: fields=formatted_address,name,geometry. استخدِم شرطة مائلة للأمام عند تحديد قيم مركّبة. على سبيل المثال: opening_hours/open_now.

تنقسم الحقول إلى ثلاث فئات للفوترة: أساسية جهة الاتصال الغلاف الجوي. يتم تحصيل رسوم عن وحدات SKU الأساسية ووحدات SKU الخاصة بجهات الاتصال ووحدات 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

الأجواء

تتضمّن فئة "الغلاف الجوي" الحقول التالية: 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، مع كل طلب، بغض النظر عمّا إذا كان قد تم طلب الحقل.
language

اللغة التي سيتم عرض النتائج بها
- اطّلِع على قائمة اللغات المتاحة. تعدّل Google غالبًا اللغات المتوافقة، لذا قد لا تكون هذه القائمة شاملة.
- في حال عدم توفير language، تحاول واجهة برمجة التطبيقات استخدام اللغة المفضّلة كما هو محدّد في العنوان Accept-Language.
- تبذل واجهة برمجة التطبيقات قصارى جهدها لتقديم عنوان شارع يمكن قراءته من قِبل المستخدمين والسكان المحليين. لتحقيق هذا الهدف، تعرض الخدمة عناوين الشوارع باللغة المحلية، مع ترجمتها إلى نص يمكن للمستخدم قراءته إذا لزم الأمر، مع مراعاة اللغة المفضّلة. يتم عرض جميع العناوين الأخرى باللغة المفضّلة. يتم عرض جميع مكونات العنوان باللغة نفسها، والتي يتم اختيارها من المكون الأول.
- إذا لم يتوفّر اسم باللغة المفضّلة، تستخدم واجهة برمجة التطبيقات أقرب نتيجة مطابِقة.
- تؤثّر اللغة المفضّلة بشكل طفيف في مجموعة النتائج التي تختار واجهة برمجة التطبيقات عرضها، وفي ترتيب عرضها. يفسّر برنامج الترميز الجغرافي الاختصارات بشكل مختلف حسب اللغة، مثل اختصارات أنواع الشوارع أو المرادفات التي قد تكون صالحة في لغة ما ولكن ليس في لغة أخرى. على سبيل المثال، utca وtér هما كلمتان مترادفتان لكلمة "شارع" باللغة الهنغارية.
المنطقة

رمز المنطقة، ويتم تحديده كقيمة مكوّنة من حرفَين لنطاق المستوى الأعلى الذي يتم ترميزه حسب البلد (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

سلسلة عشوائية تحدّد جلسة الإكمال التلقائي لأغراض الفوترة.

تبدأ الجلسة عندما يبدأ المستخدم بكتابة طلب بحث، وتنتهي عندما يختار مكانًا ويتم إجراء طلب إلى تفاصيل المكان (قديم). يمكن أن تتضمّن كل جلسة طلبات بحث متعدّدة، يليها اختيار مكان واحد. يجب أن تكون مفاتيح واجهة برمجة التطبيقات المستخدَمة في كل طلب ضمن جلسة واحدة تابعة للمشروع نفسه على Google Cloud Console. وبعد انتهاء الجلسة، لن يكون الرمز المميّز صالحًا، ويجب أن ينشئ تطبيقك رمزًا مميّزًا جديدًا لكل جلسة. في حال حذف المَعلمة sessiontoken أو إعادة استخدام رمز مميّز للجلسة، سيتم تحصيل رسوم الجلسة كما لو لم يتم تقديم رمز مميّز للجلسة (سيتم تحصيل رسوم كل طلب على حدة).

ننصحك باتّباع الإرشادات التالية:
- استخدِم رموز الجلسات المميزة لجميع جلسات الإكمال التلقائي.
- إنشاء رمز مميّز جديد لكل جلسة ننصح باستخدام معرّف فريد عالميًا من الإصدار 4.
- تأكَّد من أنّ مفاتيح واجهة برمجة التطبيقات المستخدَمة في جميع طلبات الإكمال التلقائي للمكان وطلبات تفاصيل المكان ضمن الجلسة تنتمي إلى مشروع 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 ضمن مسار عنوان URL للطلب.

JSON

{
  "html_attributions": [],
  "result":
    {
      "address_components":
        [
          { "long_name": "48", "short_name": "48", "types": ["street_number"] },
          {
            "long_name": "Pirrama Road",
            "short_name": "Pirrama Rd",
            "types": ["route"],
          },
          {
            "long_name": "Pyrmont",
            "short_name": "Pyrmont",
            "types": ["locality", "political"],
          },
          {
            "long_name": "City of Sydney",
            "short_name": "City of Sydney",
            "types": ["administrative_area_level_2", "political"],
          },
          {
            "long_name": "New South Wales",
            "short_name": "NSW",
            "types": ["administrative_area_level_1", "political"],
          },
          {
            "long_name": "Australia",
            "short_name": "AU",
            "types": ["country", "political"],
          },
          {
            "long_name": "2009",
            "short_name": "2009",
            "types": ["postal_code"],
          },
        ],
      "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "business_status": "OPERATIONAL",
      "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "formatted_phone_number": "(02) 9374 4000",
      "geometry":
        {
          "location": { "lat": -33.866489, "lng": 151.1958561 },
          "viewport":
            {
              "northeast":
                { "lat": -33.8655112697085, "lng": 151.1971156302915 },
              "southwest":
                { "lat": -33.86820923029149, "lng": 151.1944176697085 },
            },
        },
      "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
      "icon_background_color": "#7B9EB0",
      "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
      "international_phone_number": "+61 2 9374 4000",
      "name": "Google Workplace 6",
      "opening_hours":
        {
          "open_now": false,
          "periods":
            [
              {
                "close": { "day": 1, "time": "1700" },
                "open": { "day": 1, "time": "0900" },
              },
              {
                "close": { "day": 2, "time": "1700" },
                "open": { "day": 2, "time": "0900" },
              },
              {
                "close": { "day": 3, "time": "1700" },
                "open": { "day": 3, "time": "0900" },
              },
              {
                "close": { "day": 4, "time": "1700" },
                "open": { "day": 4, "time": "0900" },
              },
              {
                "close": { "day": 5, "time": "1700" },
                "open": { "day": 5, "time": "0900" },
              },
            ],
          "weekday_text":
            [
              "Monday: 9:00 AM – 5:00 PM",
              "Tuesday: 9:00 AM – 5:00 PM",
              "Wednesday: 9:00 AM – 5:00 PM",
              "Thursday: 9:00 AM – 5:00 PM",
              "Friday: 9:00 AM – 5:00 PM",
              "Saturday: Closed",
              "Sunday: Closed",
            ],
        },
      "photos":
        [
          {
            "height": 3024,
            "html_attributions":
              [
                "Cynthia Wei",
              ],
            "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX",
            "width": 4032,
          },
          {
            "height": 3264,
            "html_attributions":
              [
                "Heyang Li",
              ],
            "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI",
            "width": 4912,
          },
          {
            "height": 3036,
            "html_attributions":
              [
                "Anna Linetsky",
              ],
            "photo_reference": "Aap_uEAumTzSdhRHDutPAj6wVPSZZmBV-brI6TPFwI0tcQlbSR74z44mUPr4aXMQKck_AzHaKmbfR3P2c1qsu45i1RQPHrcpIXxrA78FmDjCdWYYZWUnFozdcmEj9OQ_V0G08adpKivMKZyeaQ1NuwRy9GhSopeKpzkzkFZG5vXMYPPSgpa1",
            "width": 4048,
          },
          {
            "height": 4016,
            "html_attributions":
              [
                "Jonah Dell",
              ],
            "photo_reference": "Aap_uECC7cSbDkh-TdmXr6m5d5pgVXJmvXg8dF2jzhL0b0Ko4CtnVll6-tIvdz7vhbCsd3hl2u9EgZ4Y30FBxKmFcimfeYUgW2XJyv8JY5IYGuXsKkCLqpV3QH9dIGwoUv2uX0eosDsUsTN2DOlyOasUgVxcYqzIzEmrL5ofIssThQWZeozD",
            "width": 6016,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Anthony Huynh",
              ],
            "photo_reference": "Aap_uEDTdw58CglFmZZAR9iZ05x3y2oK9r5_dRqKWnbZKSS9gs6gp9AeBa1QDvBL6dzZyQAZfN8H2Eppu6y4NBaPOp-GkulZYiKRM7Yww8sUEv-8dmcq35Tx38pe4LEX2wIicFkQHedRgMc0FfV9aFtgosQ5ps5-HCjJSApg8eLGyuxxqPm9",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jasen Baker",
              ],
            "photo_reference": "Aap_uEAGqslqZPhZUk0T2Y6l7mkCYnY7JN9li4g5NkZsE0N4Cdy7_cZ-fZWyV02VhpQR4Ph4fLUL6_WTXrlGMXXzUJXUcSmSTs2d_Dzf3Q_A1y07Dm-vtv7pS3JXsWyrWETGIoT1pIj81PPdUc1vlR2i3GFMWAbx9rCC472ZJclY8JlvMg-x",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBaGxeN90YFjD-AUjxZqM44kpMcICKKBBhb0RQQS7DHHFaay8RRAwjWsAt8GEmmB5QnxrbQWHU3TwhVXXHP0m-YNp9Ds3ihpiFan0moNv4QB7kern5cfjWhhrWe8B0dz_vYvmPssJE24P-24YfWWHubOo0L2MjQyueZfDv57N_RvDZk",
            "width": 4032,
          },
          {
            "height": 1515,
            "html_attributions":
              [
                "Andrew W",
              ],
            "photo_reference": "Aap_uEBDzJlmTeNUreMop6_hkC1HKTCRLyPs5fikJi58qCejtkWp5PIM6vzNN3HErkSWUwnamTr_WLyT7jXMAIdByR-hx8dG-OHjj5JxzmcPvuT_VeVLmdSbNPeIlpmp6EUcPOhaVrhEKojSd44QXkl0za29eZ0oj1KDOnAsGxmhanDFW7lI",
            "width": 2048,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBvYFpzCDQzvQ0kdBxxB70lTkLbTM0yH3xF-BCHsb7DQ63cuWnutvwv8oVLDSbA14_kns3WVlEInTyy2elvmH5lzQteb6zzRu3exkwE65_55TgJqdLO7RYYiPFliWk4ocszn9nn5ELv5uP2BQmqr9QET5vwgxR-0eshyVmcdM42jb39",
            "width": 4032,
          },
          {
            "height": 4032,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uECQynuD_EnSnbz8sJQ6-B6uR-j2tuu4Z1tuGUjq8xnxFDk-W8OdeLzWBX8suNKTCsPlkzTqC22BXf_hX33XclGPL4SS9xnPmHcMrLoUl0H_xHYevFvT17Hgw5DZpSyVmLvDvxzzJ1rsZTh55QwopmAty083a1r1ZIfL32iXh_q8FUas",
            "width": 3024,
          },
        ],
      "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "plus_code":
        {
          "compound_code": "45MW+C8 Pyrmont NSW, Australia",
          "global_code": "4RRH45MW+C8",
        },
      "rating": 4,
      "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "reviews":
        [
          {
            "author_name": "Luke Archibald",
            "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "a week ago",
            "text": "Beautiful building with a great view.",
            "time": 1652286798,
          },
          {
            "author_name": "Tevita Taufoou",
            "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "6 months ago",
            "text": "Conference rooms were well equipped.",
            "time": 1637215605,
          },
          {
            "author_name": "Jordy Baker",
            "author_url": "https://www.google.com/maps/contrib/102582237417399865640/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The staff is very friendly.",
            "time": 1641389490,
          },
          {
            "author_name": "Prem Rathod",
            "author_url": "https://www.google.com/maps/contrib/115981614018592114142/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The location is convenient and easy to find.",
            "time": 1640159655,
          },
          {
            "author_name": "Husuni Hamza",
            "author_url": "https://www.google.com/maps/contrib/102167316656574288776/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo",
            "rating": 5,
            "relative_time_description": "7 months ago",
            "text": "A modern and impressive facility.",
            "time": 1633197305,
          },
        ],
      "types": ["point_of_interest", "establishment"],
      "url": "https://maps.google.com/?cid=10281119596374313554",
      "user_ratings_total": 939,
      "utc_offset": 600,
      "vicinity": "48 Pirrama Road, Pyrmont",
      "website": "http://google.com/",
    },
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceDetailsResponse>
 <status>OK</status>
 <result>
  <name>Google Workplace 6</name>
  <vicinity>48 Pirrama Road, Pyrmont</vicinity>
  <type>point_of_interest</type>
  <type>establishment</type>
  <formatted_phone_number>(02) 9374 4000</formatted_phone_number>
  <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, Australia</formatted_address>
  <address_component>
   <long_name>48</long_name>
   <short_name>48</short_name>
   <type>street_number</type>
  </address_component>
  <address_component>
   <long_name>Pirrama Road</long_name>
   <short_name>Pirrama Rd</short_name>
   <type>route</type>
  </address_component>
  <address_component>
   <long_name>Pyrmont</long_name>
   <short_name>Pyrmont</short_name>
   <type>locality</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>City of Sydney</long_name>
   <short_name>City of Sydney</short_name>
   <type>administrative_area_level_2</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>New South Wales</long_name>
   <short_name>NSW</short_name>
   <type>administrative_area_level_1</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>Australia</long_name>
   <short_name>AU</short_name>
   <type>country</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>2009</long_name>
   <short_name>2009</short_name>
   <type>postal_code</type>
  </address_component>
  <geometry>
   <location>
    <lat>-33.8664890</lat>
    <lng>151.1958561</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8682092</lat>
     <lng>151.1944177</lng>
    </southwest>
    <northeast>
     <lat>-33.8655113</lat>
     <lng>151.1971156</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <url>https://maps.google.com/?cid=10281119596374313554</url>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference>
  <international_phone_number>+61 2 9374 4000</international_phone_number>
  <website>http://google.com/</website>
  <review>
   <time>1652286798</time>
   <text>Beautiful building with a great view.</text>
   <author_name>Luke Archibald</author_name>
   <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>a week ago</relative_time_description>
  </review>
  <review>
   <time>1637215605</time>
   <text>Conference rooms were well equipped.</text>
   <author_name>Joe Schmoe</author_name>
   <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>6 months ago</relative_time_description>
  </review>
  <review>
   <time>1641389490</time>
   <text>The staff is very friendly.</text>
   <author_name>Jordy Baker</author_name>
   <author_url>https://www.google.com/maps/contrib/102582237417399865640/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1640159655</time>
   <text>The location is convenient and easy to find.</text>
   <author_name>Prem Rathod</author_name>
   <author_url>https://www.google.com/maps/contrib/115981614018592114142/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1633197305</time>
   <text>A modern and impressive facility.</text>
   <author_name>Husuni Hamza</author_name>
   <author_url>https://www.google.com/maps/contrib/102167316656574288776/reviews</author_url>
   <rating>5.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>7 months ago</relative_time_description>
  </review>
  <opening_hours>
   <open_now>false</open_now>
   <period>
    <open>
     <day>1</day>
     <time>0900</time>
    </open>
    <close>
     <day>1</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>2</day>
     <time>0900</time>
    </open>
    <close>
     <day>2</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>3</day>
     <time>0900</time>
    </open>
    <close>
     <day>3</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>4</day>
     <time>0900</time>
    </open>
    <close>
     <day>4</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>5</day>
     <time>0900</time>
    </open>
    <close>
     <day>5</day>
     <time>1700</time>
    </close>
   </period>
   <weekday_text>Monday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Tuesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Wednesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Thursday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Friday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Saturday: Closed</weekday_text>
   <weekday_text>Sunday: Closed</weekday_text>
  </opening_hours>
  <utc_offset>600</utc_offset>
  <photo>
   <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/117600448889234589608&quot;&gt;Cynthia Wei&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference>
   <width>4912</width>
   <height>3264</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102493344958625549078&quot;&gt;Heyang Li&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBXOmqXNblj10HJavekmUNyUwccggfNN9KVE9TjYcU9HXkBHdvnwfYHDx3dfrjJJwnN8yooP-5412iJNRk8cwUbAVYbD2326cfiJJ3oK6pOrAi1oBmCYuAwKTHnX3EQvSbheVhJZPNDHlT5TjKcwfwAb80eyLB2UNyWl3Y6D7YS7ZSf</photo_reference>
   <width>4048</width>
   <height>3036</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/104829437842034782235&quot;&gt;Anna Linetsky&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAWyGsK1fp3SE73xICq8FJNlrVVqRk8E6YfMiz-o8IJj1vESmuDj4NnPDP4S2kWFrfoBpqw9lmXBGxtYo6nPMySfBAcRIbdEg0ko4dcdzsBvo6cRUz9XpmlcoptCpIAKEb6f7Bh_OD0zFntYbTz-pLdQ9ZHB8tBvTb3kzfTdK2Du0yC</photo_reference>
   <width>6016</width>
   <height>4016</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/107755640736541028674&quot;&gt;Jonah Dell&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAxbn61tx1hwCo3kUMd2KPlWaBkrFhXHxsZDgkYxpJqc-ZYC6U0MH6urfbHVrwmMoosOG0G39anmR68B7p2Up3AACxTa21vCopSL6-RHIphVsBhfhOrFMlGNqBDEsnmY15X0FzzNMKASXqmqtzBphiRyGhAFKfRs3Js1ymXP_FWjqzT</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/115886271727815775491&quot;&gt;Anthony Huynh&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEClwnjuvgS58OknaXxZeVGf5ydyG6U6lO9srr8FU7tPoZ4DvqQo-GUeemssC11tzDBUMWit4ILWF-GmlRfIHS8FuAtttOgp2wvgPhs-ADUrznLRXYKBRkNQnRLEIA1PBgJN9Eev8tFWxpY_jBMklkEUZJRjm-mk9R0bSKSelpPgMYAz</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102939237947063969663&quot;&gt;Jasen Baker&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBvISYtwjSgTQntTJJ_-XhPUF4CVCQF3wxM0FjcQJuzomYLfZWFlIWsOgXhwt2Sd8K6OqFrSP8XHHrBaqQJHD-om-H_wfRLVmiAoQa8QG5oxt540AucTMP4H2QfhTXngqEoNuOcbb-xo2l01OPUetTdIZQ3S6U5s2iyGrHpTs3qz8CH</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEB2cYxbKE7uIXQ_IhX3TvZHDcFHXjWSwezoiwP3eWlfIDTWwq3xtsYZY7QSrhR2d9s1eWmZlM5zr9iHlC_n0gsJXNeRcfd2JjuLFaNuC7VfpeIsdQchhOybG0drJ2CxzD187Az-Foip-6MutDA22LINPw0Iyc_yT04WbxQDxhiwu2Cn</photo_reference>
   <width>2048</width>
   <height>1515</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112343109286948028063&quot;&gt;Andrew W&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBJyLgeilgow1JnoKW83IBsl8CPkmryN8nGYtBzzLaiLjFicWxC1YPQusM-_Fvfb1bkbuShrzjXmHCOp5HoBgJsgit8o0HPYWgjSwrdySqde1BgfKbwS-TWbPg_dwTnVR8LrVPxa_vpLzNlx1b-WpDZo3-_KvxH2GARhVrcvWkvMYD0</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEADyMSxLevgbLWCJeHA8kIN3w6-JcndbuHvTB0oqR-IlWbml4bbYmR-_iYU15HBh8xi3w5hZ455pda6m-BlLCscr6g_Zc5FmBOHW56IsZF3Pxif5UmeGZSsg3WIjHCoL-JyndN0nkfyzS31E05tZi61RfXQ2UPY2_5ceKYua5U6d5Zd</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <adr_address>&lt;span class=&quot;street-address&quot;&gt;48 Pirrama Rd&lt;/span&gt;, &lt;span class=&quot;locality&quot;&gt;Pyrmont&lt;/span&gt; &lt;span class=&quot;region&quot;&gt;NSW&lt;/span&gt; &lt;span class=&quot;postal-code&quot;&gt;2009&lt;/span&gt;, &lt;span class=&quot;country-name&quot;&gt;Australia&lt;/span&gt;</adr_address>
  <user_ratings_total>939</user_ratings_total>
  <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id>
  <plus_code>
   <global_code>4RRH45MW+C8</global_code>
   <compound_code>45MW+C8 Pyrmont NSW, Australia</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceDetailsResponse>

يحتوي كل من ردود JSON وXML على العناصر التالية:

PlacesDetailsResponse

الحقل	مطلوب	النوع	الوصف
`html_attributions`	مطلوب	Array<string>	قد يحتوي على مجموعة من معلومات تحديد المصدر حول هذا الإدخال يجب عرضها للمستخدم (قد لا تتضمّن بعض الإدخالات معلومات تحديد المصدر).
`result`	مطلوب	مكان	تحتوي على معلومات مفصّلة حول المكان المطلوب. يمكنك الاطّلاع على مكان لمزيد من المعلومات.
`status`	مطلوب	PlacesDetailsStatus	يحتوي على حالة الطلب، وقد يتضمّن معلومات تصحيح الأخطاء لمساعدتك في معرفة سبب تعذُّر تلبية الطلب. يمكنك الاطّلاع على PlacesDetailsStatus لمزيد من المعلومات.
`info_messages`	اختياري	Array<string>	عندما تعرض الخدمة معلومات إضافية حول مواصفات الطلب، قد يظهر حقل `info_messages` إضافي ضمن عنصر الردّ. لا يتم عرض هذا الحقل إلا للطلبات الناجحة. وقد لا يتم عرضها دائمًا، ويخضع محتواها للتغيير.

في استجابة JSON، يتم تمثيلها كعناصر جذرية. في استجابة XML، تظهر هذه العناصر كعناصر ذات مستوى أعلى ضمن <PlaceDetailsResponse>.

PlacesDetailsStatus

رموز الحالة التي تعرضها الخدمة

OK يشير إلى أنّ طلب البيانات من واجهة برمجة التطبيقات تمّ بنجاح.
‫ZERO_RESULTS للإشارة إلى أنّ الموقع الجغرافي المشار إليه، place_id، كان صالحًا ولكنّه لم يعُد يشير إلى نتيجة صالحة. قد يحدث ذلك إذا لم يعُد المكان متاحًا.
NOT_FOUND، ما يشير إلى أنّه لم يتم العثور على الموقع الجغرافي المشار إليه، place_id، في قاعدة بيانات "أماكن".
INVALID_REQUEST للإشارة إلى أنّ طلب البيانات من واجهة برمجة التطبيقات تمت صياغته بشكل غير صحيح.
OVER_QUERY_LIMIT التي تشير إلى أي مما يلي:
- لقد تجاوزت الحد الأقصى لعدد الطلبات في الثانية.
- لم يتم تفعيل الفوترة في حسابك.
- تم تجاوز الرصيد الشهري البالغ 200 دولار أمريكي أو الحد الأقصى للاستخدام الذي فرضته على نفسك.
- طريقة الدفع المقدَّمة لم تعُد صالحة (على سبيل المثال، انتهت صلاحية بطاقة الائتمان).
لمزيد من المعلومات حول كيفية حلّ هذا الخطأ، يُرجى الاطّلاع على الأسئلة الشائعة حول "خرائط Google".
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	تحتوي هذه السمة على ساعات العمل للأيام السبعة المقبلة (بما في ذلك اليوم). تبدأ الفترة الزمنية في منتصف الليل من تاريخ الطلب وتنتهي في الساعة 11:59 مساءً بعد ستة أيام. يتضمّن هذا الحقل الحقل الفرعي `special_days` لجميع الساعات المحدّدة للتواريخ التي تتضمّن ساعات عمل استثنائية. يمكنك الاطّلاع على PlaceOpeningHours لمزيد من المعلومات.
`delivery`	اختياري	قيمة منطقية	تحدّد هذه السمة ما إذا كان النشاط التجاري يقدّم خدمة التوصيل.
`dine_in`	اختياري	قيمة منطقية	تحدّد هذه السمة ما إذا كان النشاط التجاري يوفّر خيارات للجلوس في أماكن داخلية أو خارجية.
`editorial_summary`	اختياري	PlaceEditorialSummary	يحتوي على ملخّص عن المكان. يتألف الملخّص من نظرة عامة نصية، ويتضمّن أيضًا رمز اللغة إذا كان ذلك منطبقًا. يجب عرض النص الموجز كما هو، ولا يمكن تعديله أو تغييره. لمزيد من المعلومات، يُرجى الاطّلاع على PlaceEditorialSummary.
`formatted_address`	اختياري	سلسلة	سلسلة تحتوي على العنوان الذي يمكن لشخص عادي قراءته لهذا المكان وغالبًا ما يكون هذا العنوان مطابقًا للعنوان البريدي. يُرجى العِلم أنّ بعض البلدان، مثل المملكة المتحدة، لا تسمح بتوزيع العناوين البريدية الحقيقية بسبب القيود المفروضة على الترخيص. يتألف العنوان المنسّق منطقيًا من عنصر واحد أو أكثر من عناصر العنوان. على سبيل المثال، يتألف العنوان "111 شارع 8، نيويورك، نيويورك" من المكوّنات التالية: "111" (رقم الشارع)، و"شارع 8" (الطريق)، و"نيويورك" (المدينة)، و "نيويورك" (ولاية الولايات المتحدة). لا تحلّل العنوان المنسَّق آليًا. بدلاً من ذلك، عليك استخدام مكوّنات العنوان الفردية التي تتضمّنها استجابة واجهة برمجة التطبيقات بالإضافة إلى حقل العنوان المنسّق.
`formatted_phone_number`	اختياري	سلسلة	يحتوي على رقم هاتف المكان بالتنسيق المحلي.
`geometry`	اختياري	`Geometry`	يحتوي على الموقع الجغرافي ونافذة العرض الخاصة به. يمكنك الاطّلاع على `Geometry` لمزيد من المعلومات.
`icon`	اختياري	سلسلة	يحتوي على عنوان URL لرمز مقترَح يمكن عرضه للمستخدم عند الإشارة إلى هذه النتيجة على خريطة.
`icon_background_color`	اختياري	سلسلة	تحتوي هذه السمة على رمز HEX التلقائي للون فئة المكان.
`icon_mask_base_uri`	اختياري	سلسلة	تحتوي هذه السمة على عنوان URL لرمز مقترَح، باستثناء امتداد نوع الملف `.svg` أو `.png`.
`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`	مرجع موقع جغرافي مشفّر، مشتق من إحداثيات خطوط الطول والعرض، ويمثّل منطقة: 1/8000 من الدرجة في 1/8000 من الدرجة (حوالي 14 مترًا × 14 مترًا عند خط الاستواء) أو أصغر. يمكن استخدام رموز Plus كبديل لعناوين الشوارع في الأماكن التي لا تتوفّر فيها (حيث لا يتم ترقيم المباني أو تسمية الشوارع). اطّلِع على Open Location Code ورموز Plus Codes. يمكنك الاطّلاع على `PlusCode` لمزيد من المعلومات.
`price_level`	اختياري	الرقم	مستوى سعر المكان، على مقياس من 0 إلى 4 سيختلف المبلغ الدقيق الذي تشير إليه قيمة معيّنة من منطقة إلى أخرى. يتم تفسير مستويات الأسعار على النحو التالي: ‫0 مجانًا ‫1 غير مُكلِف ‫2 معتدلة ‫3 Expensive ‫4 غالٍ جدًا
`rating`	اختياري	الرقم	تحتوي هذه السمة على تقييم المكان، من 1.0 إلى 5.0، استنادًا إلى مراجعات المستخدمين المجمَّعة.
`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`	اختياري	سلسلة	يحتوي على عنوان URL الخاص بصفحة Google الرسمية لهذا المكان. ستكون هذه الصفحة من ملكية Google، وستتضمّن أفضل المعلومات المتوفّرة حول المكان. يجب أن تتضمّن التطبيقات رابطًا إلى هذه الصفحة أو أن تدمجها في أي شاشة تعرض للمستخدم نتائج تفصيلية حول المكان.
`user_ratings_total`	اختياري	الرقم	تمثّل هذه السمة إجمالي عدد المراجعات التي تتضمّن نصًا أو لا تتضمّنه لهذا المكان.
`utc_offset`	اختياري	الرقم	تحتوي هذه السمة على عدد الدقائق التي ينحرف بها التوقيت الحالي لهذا المكان عن التوقيت العالمي المتفق عليه. على سبيل المثال، بالنسبة إلى الأماكن في سيدني، أستراليا، خلال نظام التوقيت الصيفي، سيكون هذا الرقم 660 (+11 ساعة من التوقيت العالمي المتفق عليه)، وبالنسبة إلى الأماكن في كاليفورنيا خارج نظام التوقيت الصيفي، سيكون هذا الرقم -480 (-8 ساعات من التوقيت العالمي المتفق عليه).
`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`	مطلوب	الرقم	رقم من 0 إلى 6، يتوافق مع أيام الأسبوع، بدءًا من يوم الأحد. على سبيل المثال، يشير الرقم 2 إلى يوم الثلاثاء.
`time`	مطلوب	سلسلة	قد يحتوي على وقت من اليوم بتنسيق hhmm على مدار 24 ساعة. تتراوح القيم بين 0000 و2359. سيتم عرض الوقت في المنطقة الزمنية للمكان.
`date`	اختياري	سلسلة	تمثّل هذه السمة تاريخًا بالتنسيق RFC3339 في المنطقة الزمنية المحلية للمكان، مثلاً 2010-12-31.
`truncated`	اختياري	قيمة منطقية	تكون القيمة "صحيح" إذا تم اقتطاع فترة زمنية معيّنة بسبب حدّ أقصى يبلغ سبعة أيام، حيث تبدأ الفترة قبل منتصف الليل في تاريخ الطلب و/أو تنتهي عند منتصف الليل أو بعده في اليوم الأخير. تشير هذه السمة إلى أنّ فترة الفتح أو الإغلاق يمكن أن تمتد إلى ما بعد هذا الحدّ الأقصى البالغ سبعة أيام.

PlacePhoto

صورة لمكان يمكن الوصول إلى الصورة باستخدام واجهة برمجة التطبيقات Place Photo من خلال عنوان URL بالتنسيق التالي:

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`	مطلوب	سلسلة	سلسلة تُستخدَم لتحديد الصورة عند تنفيذ طلب Photo.
`width`	مطلوب	الرقم	عرض الصورة

PlaceReview

مراجعة للمكان أرسلها أحد المستخدمين

الحقل	مطلوب	النوع	الوصف
`author_name`	مطلوب	سلسلة	تمثّل هذه السمة اسم المستخدم الذي أرسل المراجعة. تتم إضافة المراجعات المجهولة المصدر إلى "مستخدم Google".
`rating`	مطلوب	الرقم	تمثّل هذه السمة التقييم الإجمالي الذي قدّمه المستخدم لهذا المكان. هذا الرقم هو عدد صحيح يتراوح بين 1 و5.
`relative_time_description`	مطلوب	سلسلة	تمثّل هذه السمة الوقت الذي تم فيه إرسال المراجعة كنص، وذلك بالنسبة إلى الوقت الحالي.
`time`	مطلوب	الرقم	تمثّل هذه السمة الوقت الذي تم فيه إرسال المراجعة، ويتم قياسه بعدد الثواني المنقضية منذ منتصف ليل 1 يناير 1970 بالتوقيت العالمي المنسق.
`author_url`	اختياري	سلسلة	تمثّل هذه السمة عنوان URL للملف الشخصي للمستخدم في برنامج "المرشدون المحليون" على "خرائط Google"، إذا كان متاحًا.
`language`	اختياري	سلسلة	تمثّل هذه السمة رمز لغة IETF يشير إلى لغة المراجعة المعروضة.يحتوي هذا الحقل على علامة اللغة الرئيسية فقط، وليس العلامة الثانوية التي تشير إلى البلد أو المنطقة. على سبيل المثال، يتم تصنيف جميع المراجعات باللغة الإنجليزية على أنّها "en"، وليس "en-AU" أو "en-UK" وما إلى ذلك.يكون هذا الحقل فارغًا إذا كان هناك تقييم فقط بدون نص مراجعة.
`original_language`	اختياري	سلسلة	تمثّل هذه السمة رمز لغة IETF يشير إلى اللغة الأصلية للمراجعة. إذا تمت ترجمة المراجعة، ستكون قيمة `original_language` مختلفة عن قيمة `language`.يحتوي هذا الحقل على علامة اللغة الرئيسية فقط، وليس على العلامة الثانوية التي تشير إلى البلد أو المنطقة. على سبيل المثال، يتم تصنيف جميع المراجعات باللغة الإنجليزية على أنّها "en"، وليس "en-AU" أو "en-UK" وما إلى ذلك.ويكون هذا الحقل فارغًا إذا كان هناك تقييم فقط بدون نص مراجعة.
`profile_photo_url`	اختياري	سلسلة	تمثّل هذه السمة عنوان URL الخاص بصورة الملف الشخصي للمستخدم، إذا كان ذلك متاحًا.
`text`	اختياري	سلسلة	مراجعة المستخدم عند مراجعة موقع جغرافي باستخدام Google Places، تُعتبر المراجعات النصية اختيارية. لذلك، قد يكون هذا الحقل فارغًا. يُرجى العِلم أنّ هذا الحقل قد يتضمّن ترميز HTML أساسيًا. على سبيل المثال، قد يمثّل مرجع الكيان `&` علامة العطف (&).
`translated`	اختياري	قيمة منطقية	قيمة منطقية تشير إلى ما إذا تمت ترجمة المراجعة من اللغة الأصلية التي كُتبت بها.إذا تمت ترجمة المراجعة، أي إذا كانت القيمة صحيحة، تنصح Google بالإشارة إلى ذلك للمستخدمين. على سبيل المثال، يمكنك إضافة السلسلة التالية "مترجَمة بواسطة Google" إلى المراجعة.

تفاصيل المكان (الإصدار القديم) تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

طلبات "تفاصيل المكان" (الإصدار القديم)

المعلمات المطلوبة

place_id

المعلمات الاختيارية

fields

language

المنطقة

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`