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

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

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

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

طلب "تفاصيل المكان (قديم)" هو عنوان URL يستخدم HTTP بالشكل التالي:

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

حيث يمكن أن تكون output أيًا من القيم التالية:

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

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

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

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

  • fields

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

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

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

    الأساسية

    تتضمّن الفئة "الأساسية" الحقول التالية: 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، مع بعض الاستثناءات الملحوظة. على سبيل المثال، نطاق المستوى الأعلى الذي يتم ترميزه حسب البلد (ccTLD) الذي يمثّل المملكة المتحدة هو "uk"‏ (‎.co.uk)، في حين أنّ رمز المنظمة الدولية للمعايير (ISO) 3166-1 الخاص بها هو "gb" (وهو من الناحية الفنية يمثّل "كيان" "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").

  • reviews_no_translations

    حدِّد reviews_no_translations=true لإيقاف ترجمة المراجعات، أو حدِّد reviews_no_translations=false لتفعيل ترجمة المراجعات. يتم عرض المراجعات بلغتها الأصلية.

    في حال حذف هذه المَعلمة أو تمريرها بدون قيمة، سيتم تفعيل ترجمة المراجعات. إذا تم تحديد المَعلمة language في الطلب، استخدِم اللغة المحدّدة كلغة مفضّلة للترجمة. في حال حذف language، تحاول واجهة برمجة التطبيقات استخدام العنوان Accept-Language كلغة مفضّلة.

  • reviews_sort

    طريقة الترتيب التي يجب استخدامها عند عرض المراجعات يمكن ضبطها على most_relevant (القيمة التلقائية) أو newest.

    • بالنسبة إلى most_relevant (الإعداد التلقائي)، يتم ترتيب المراجعات حسب مدى صلتها بموضوع البحث، وستعطي الخدمة الأولوية للنتائج التي تعرض المراجعات المكتوبة في الأصل باللغة المفضّلة.
    • بالنسبة إلى newest، يتم ترتيب المراجعات حسب التسلسل الزمني، ولا تؤثر اللغة المفضّلة في نظام الترتيب.

    تنصح Google بعرض طريقة ترتيب المراجعات للمستخدم النهائي.

  • sessiontoken

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

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

    ننصحك باتّباع الإرشادات التالية:

    • استخدِم الرموز المميّزة للجلسات في جميع جلسات الإكمال التلقائي.
    • أنشِئ رمزًا مميزًا جديدًا لكل جلسة. ننصح باستخدام معرّف UUID من الإصدار 4.
    • تأكَّد من أنّ مفاتيح واجهة برمجة التطبيقات المستخدَمة لجميع طلبات "الإكمال التلقائي للأماكن" و"تفاصيل المكان" ضمن جلسة معيّنة تنتمي إلى مشروع Cloud Console نفسه.
    • تأكَّد من تمرير رمز مميّز فريد لكل جلسة جديدة. سيؤدي استخدام الرمز المميّز نفسه لأكثر من جلسة واحدة إلى إصدار فاتورة لكل طلب على حدة.

مثال على تفاصيل المكان (قديم)

يطلب المثال التالي تفاصيل مكان حسب place_id، ويتضمّن الحقول name وrating وformatted_phone_number:

محارة

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

HTTP

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

استبدِل المفتاح في هذا المثال بمفتاح واجهة برمجة التطبيقات الخاص بك لكي يعمل الطلب في تطبيقك.

استجابة تفاصيل المكان (الإصدار القديم)

يتم عرض ردود "تفاصيل المكان (الإصدار القديم)" بالتنسيق الذي تشير إليه العلامة output ضمن مسار عنوان 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,
          },
          // ...
        ],
      "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

الحقل مطلوب النوع الوصف
مطلوب Array<string>

قد يحتوي على مجموعة من السمات حول هذه البيانات التي يجب عرضها للمستخدم (قد لا تحتوي بعض البيانات على سمات).

مطلوب المكان

يحتوي على معلومات مفصّلة عن المكان المطلوب.

يمكنك الاطّلاع على المكان لمزيد من المعلومات.

مطلوب PlacesDetailsStatus

يحتوي على حالة الطلب، وقد يحتوي على معلومات تصحيح الأخطاء لمساعدتك في تتبُّع سبب تعذُّر الطلب.

يمكنك الاطّلاع على PlacesDetailsStatus لمزيد من المعلومات.

اختياري Array<string>

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

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

PlacesDetailsStatus

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

  • ‫OK يشير إلى أنّ طلب البيانات من واجهة برمجة التطبيقات تم بنجاح.
  • ‫ZERO_RESULTS تشير إلى أنّ الموقع الجغرافي المُشار إليه، place_id، كان صالحًا ولكنّه لم يعُد يشير إلى نتيجة صالحة. قد يحدث ذلك إذا لم تعُد المؤسسة تعمل.
  • ‫NOT_FOUND تشير إلى أنّه لم يتم العثور على الموقع الجغرافي المُشار إليه، place_id، في قاعدة بيانات "الأماكن".
  • ‫INVALID_REQUEST يشير إلى أنّ طلب البيانات من واجهة برمجة التطبيقات تم تنسيقه بشكل غير صحيح.
  • OVER_QUERY_LIMIT يشير إلى أي مما يلي:
    • لقد تجاوزت الحد المسموح به لعدد الطلبات في الثانية (QPS).
    • لم يتم تفعيل الفوترة في حسابك.
    • تم تجاوز الرصيد الشهري البالغ 200 دولار أمريكي أو الحد الأقصى للاستخدام الذي فرضته بنفسك.
    • طريقة الدفع المقدَّمة لم تعُد صالحة (على سبيل المثال، انتهت صلاحية بطاقة الائتمان).
    يمكنك الاطّلاع على الأسئلة الشائعة حول &quot;خرائط Google&quot; لمزيد من المعلومات حول كيفية حلّ هذا الخطأ.
  • REQUEST_DENIED يشير إلى رفض طلبك، وذلك بشكل عام بسبب:
    • لا يتضمّن الطلب مفتاح واجهة برمجة التطبيقات.
    • المَعلمة key غير صالحة.
  • ‫UNKNOWN_ERROR تشير إلى حدوث خطأ غير معروف.

المكان

سمات تصف مكانًا لن تكون بعض السمات متاحة لبعض أنواع الأماكن.

الحقل مطلوب النوع الوصف
اختياري Array<AddressComponent>

مصفوفة تحتوي على المكوّنات المنفصلة التي تنطبق على هذا العنوان.

يمكنك الاطّلاع على AddressComponent لمزيد من المعلومات.

اختياري سلسلة

تمثيل لعنوان المكان في التنسيق المصغّر adr

اختياري سلسلة

تشير إلى حالة التشغيل للمكان، إذا كان مؤسسة. في حال عدم توفّر أي بيانات، لن يتم عرض السمة business_status.

The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
اختياري قيمة منطقية

تحدّد ما إذا كانت المؤسسة تتيح الاستلام من السيارة.

اختياري PlaceOpeningHours

يحتوي على ساعات العمل للأيام السبعة المقبلة (بما في ذلك اليوم). تبدأ الفترة الزمنية في منتصف الليل من تاريخ الطلب وتنتهي في الساعة 11:59 مساءً بعد ستة أيام. يتضمّن هذا الحقل الحقل الفرعي special_days لجميع الساعات، ويتم ضبطه للتواريخ التي تتضمّن ساعات عمل استثنائية.

لمزيد من المعلومات، يمكنك الاطّلاع على PlaceOpeningHours.

اختياري قيمة منطقية

تحدّد ما إذا كانت المؤسسة توفّر خدمة التوصيل.

اختياري قيمة منطقية

تحدّد هذه السمة ما إذا كانت المؤسسة توفّر خيارات جلوس داخلية أو خارجية.

اختياري PlaceEditorialSummary

يحتوي على ملخّص عن المكان. يتألف الملخّص من نظرة عامة نصية، ويتضمّن أيضًا رمز اللغة لهذه النظرة العامة إن أمكن. يجب عرض نص الملخّص كما هو ولا يمكن تعديله أو تغييره.

لمزيد من المعلومات، يمكنك الاطّلاع على PlaceEditorialSummary.

اختياري سلسلة

سلسلة تحتوي على عنوان هذا المكان ويمكن لشخص عادي قراءته

غالبًا ما يكون هذا العنوان مطابقًا للعنوان البريدي. يُرجى العِلم أنّ بعض البلدان، مثل المملكة المتحدة، لا تسمح بتوزيع العناوين البريدية الصحيحة بسبب قيود الترخيص.

يتكوّن العنوان المنسَّق منطقيًا من مكوّن واحد أو أكثر من مكوّنات العنوان. على سبيل المثال، يتألف العنوان "111 8th Avenue, New York, NY" من المكوّنات التالية: "111" (رقم الشارع) و"8th Avenue" (الطريق) و"New York" (المدينة) و "NY" (الولاية الأمريكية).

لا تحلّل العنوان المنسَّق آليًا. بدلاً من ذلك، يجب استخدام مكوّنات العنوان الفردية التي يتضمّنها ردّ من واجهة برمجة التطبيقات بالإضافة إلى حقل العنوان المنسَّق.

اختياري سلسلة

يحتوي على رقم هاتف المكان بالتنسيق المحلي.

اختياري Geometry

يحتوي على الموقع الجغرافي وإطار العرض الخاص به.

يمكنك الاطّلاع على Geometry لمزيد من المعلومات.

اختياري سلسلة

يحتوي على عنوان URL لرمز مقترَح قد يتم عرضه للمستخدم عند الإشارة إلى هذه النتيجة على خريطة.

اختياري سلسلة

يحتوي على رمز اللون الست عشري التلقائي لفئة المكان.

اختياري سلسلة

تحتوي على عنوان URL لرمز مقترَح، باستثناء امتداد نوع الملف .svg أو .png.

اختياري سلسلة

يحتوي على رقم هاتف المكان بالتنسيق الدولي. يتضمّن التنسيق الدولي رمز البلد، وتسبقه علامة الجمع (+). على سبيل المثال، رقم الهاتف الدولي لمكتب Google في سيدني، أستراليا هو +61 2 9374 4000.

اختياري سلسلة

تحتوي على الاسم الذي يمكن لشخص عادي قراءته للنتيجة المعروضة. بالنسبة إلى نتائج establishment، يكون هذا عادةً اسم النشاط التجاري الأساسي.

اختياري PlaceOpeningHours

يحتوي على ساعات العمل العادية.

لمزيد من المعلومات، يمكنك الاطّلاع على PlaceOpeningHours.

اختياري قيمة منطقية

استخدِم business_status للحصول على حالة العمل للمؤسسات.

اختياري صفيف<PlacePhoto>

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

يُرجى الاطّلاع على PlacePhoto لمزيد من المعلومات.

اختياري سلسلة

معرّف نصي يحدّد مكانًا بشكل فريد. لاسترداد معلومات عن المكان، أدخِل هذا المعرّف في حقل place_id في طلب بيانات من واجهة برمجة التطبيقات Places API. لمزيد من المعلومات حول أرقام تعريف الأماكن، يُرجى الاطّلاع على نظرة عامة على رقم تعريف المكان.

اختياري PlusCode

مرجع موقع جغرافي مشفّر، مشتق من إحداثيات خطوط العرض والطول، يمثّل منطقة: 1/8000 من الدرجة في 1/8000 من الدرجة (حوالي 14 مترًا × 14 مترًا عند خط الاستواء) أو أصغر. يمكن استخدام رموز Plus Codes كبديل لعناوين الشوارع في الأماكن التي لا تتوفّر فيها هذه العناوين (حيث لا يتم ترقيم المباني أو تسمية الشوارع). يُرجى الاطّلاع على رمز الموقع المفتوح ورموز Plus Codes.

يمكنك الاطّلاع على PlusCode لمزيد من المعلومات.

اختياري الرقم

مستوى سعر المكان، على مقياس من 0 إلى 4 سيختلف المبلغ الدقيق الذي تشير إليه قيمة معيّنة من منطقة إلى أخرى. يتم تفسير مستويات الأسعار على النحو التالي:

  • ‫0 مجانًا
  • ‫1 غير مكلف
  • ‫2 معتدل
  • ‫3 أسعار غالية
  • ‫4 غالٍ جدًا
اختياري الرقم

يحتوي على تقييم المكان، من 1.0 إلى 5.0، استنادًا إلى مراجعات المستخدمين المجمّعة.

اختياري سلسلة
اختياري قيمة منطقية

تحدّد ما إذا كان المكان يتيح إجراء الحجوزات.

اختياري Array<PlaceReview>

مصفوفة JSON تتضمّن ما يصل إلى خمس مراجعات يتم ترتيب المراجعات تلقائيًا حسب مدى صلتها بموضوع البحث. استخدِم مَعلمة الطلب reviews_sort للتحكّم في الترتيب.

  • بالنسبة إلى most_relevant (الإعداد التلقائي)، يتم ترتيب المراجعات حسب مدى صلتها بموضوع البحث، وستعطي الخدمة الأولوية للنتائج التي تعرض المراجعات المكتوبة في الأصل باللغة المفضّلة.
  • بالنسبة إلى newest، يتم ترتيب المراجعات حسب التسلسل الزمني، ولا تؤثر اللغة المفضّلة في نظام الترتيب.

تنصح Google بأن توضّح للمستخدمين ما إذا كانت النتائج مرتّبة حسب most_relevant أو newest.

لمزيد من المعلومات، يمكنك الاطّلاع على PlaceReview.

اختياري سلسلة
اختياري Array<PlaceOpeningHours>

تحتوي على مصفوفة من الإدخالات للأيام السبعة التالية، بما في ذلك معلومات عن ساعات العمل الثانوية لمؤسسة. تختلف ساعات العمل الثانوية عن ساعات العمل الرئيسية للمؤسسة. على سبيل المثال، يمكن لمطعم تحديد ساعات عمل الطلبات من السيارة أو ساعات عمل خدمة التوصيل كساعات عمل ثانوية. يملأ هذا الحقل الحقل الفرعي type الذي يستند إلى قائمة محدّدة مسبقًا من أنواع ساعات العمل (مثل DRIVE_THROUGH أو PICKUP أو TAKEOUT) استنادًا إلى أنواع المكان. يتضمّن هذا الحقل الحقل الفرعي special_days لجميع الساعات، ويتم ضبطه للتواريخ التي تتضمّن ساعات عمل استثنائية.

لمزيد من المعلومات، يمكنك الاطّلاع على PlaceOpeningHours.

اختياري قيمة منطقية

تحدّد ما إذا كان المكان يقدّم البيرة.

اختياري قيمة منطقية

تحدّد ما إذا كان المكان يقدّم وجبة الفطور.

اختياري قيمة منطقية

تحدّد ما إذا كان المكان يقدّم وجبات الإفطار المتأخر.

اختياري قيمة منطقية

تحدّد هذه السمة ما إذا كان المكان يقدّم العشاء.

اختياري قيمة منطقية

تحدّد ما إذا كان المكان يقدّم وجبة الغداء.

اختياري قيمة منطقية

تحدّد ما إذا كان المكان يقدّم مأكولات نباتية.

اختياري قيمة منطقية

تحدّد هذه السمة ما إذا كان المكان يقدّم النبيذ.

اختياري قيمة منطقية

تحدّد ما إذا كان النشاط التجاري يوفّر خدمة الطلبات الخارجية.

اختياري Array<string>

يحتوي على مصفوفة من أنواع الميزات التي تصف النتيجة المحدّدة. اطّلِع على قائمة الأنواع المتوافقة.

اختياري سلسلة

يحتوي على عنوان URL لصفحة Google الرسمية لهذا المكان. وستكون هذه الصفحة مملوكة لـ Google وتحتوي على أفضل المعلومات المتاحة عن المكان. يجب أن تتضمّن التطبيقات رابطًا يؤدي إلى هذه الصفحة أو أن تدمجها في أي شاشة تعرض نتائج تفصيلية عن المكان للمستخدم.

اختياري الرقم

إجمالي عدد المراجعات لهذا المكان، سواء كانت تحتوي على نص أم لا

اختياري الرقم

يحتوي على عدد الدقائق التي تختلف بها المنطقة الزمنية الحالية لهذا المكان عن التوقيت العالمي المنسق (UTC). على سبيل المثال، بالنسبة إلى الأماكن في سيدني، أستراليا خلال نظام التوقيت الصيفي، ستكون هذه القيمة 660 (+11 ساعة من التوقيت العالمي المنسق)، وبالنسبة إلى الأماكن في كاليفورنيا خارج نظام التوقيت الصيفي، ستكون هذه القيمة -480 (-8 ساعات من التوقيت العالمي المنسق).

اختياري سلسلة

بالنسبة إلى نتائج المؤسسات (types:["establishment", ...]) فقط)، يحتوي الحقل vicinity على عنوان مبسّط للمكان، بما في ذلك اسم الشارع ورقمه والمنطقة، ولكن ليس المقاطعة/الولاية أو الرمز البريدي أو البلد.

بالنسبة إلى جميع النتائج الأخرى، يحتوي الحقل vicinity على اسم المَعلم السياسي (types:["political", ...]) الأكثر تحديدًا والموجود في عنوان النتيجة.

هذا المحتوى مخصّص للقراءة كما هو، لذا لا تحلّل العنوان المنسَّق آليًا.

اختياري سلسلة

الموقع الإلكتروني الموثوق لهذا المكان، مثل الصفحة الرئيسية لنشاط تجاري

اختياري قيمة منطقية

تحدّد ما إذا كان المكان يحتوي على مدخل مناسب لأصحاب الكراسي المتحرّكة.

PlaceEditorialSummary

يحتوي على ملخّص عن المكان. يتألف الملخّص من نظرة عامة نصية، ويتضمّن أيضًا رمز اللغة لهذه النظرة العامة إن توفّر. ويجب عرض نص الملخّص كما هو، ولا يمكن تعديله أو تغييره.

الحقل مطلوب النوع الوصف
اختياري سلسلة

تمثّل هذه السمة لغة الحقول السابقة. قد لا تكون موجودة دائمًا.

اختياري سلسلة

ملخّص نصي متوسط الطول للمكان

PlaceOpeningHours

تمثّل هذه السمة ساعات عمل المكان.

الحقل مطلوب النوع الوصف
اختياري قيمة منطقية

قيمة منطقية تشير إلى ما إذا كان المكان مفتوحًا في الوقت الحالي

اختياري Array<PlaceOpeningHoursPeriod>

مصفوفة من فترات العمل تغطي سبعة أيام، بدءًا من الأحد، بترتيب زمني.

لمزيد من المعلومات، يمكنك الاطّلاع على PlaceOpeningHoursPeriod.

اختياري Array<PlaceSpecialDay>

مصفوفة تتضمّن ما يصل إلى سبعة إدخالات تتوافق مع الأيام السبعة التالية.

يمكنك الاطّلاع على PlaceSpecialDay لمزيد من المعلومات.

اختياري سلسلة

سلسلة نوع تُستخدَم لتحديد نوع ساعات العمل الثانوية (على سبيل المثال، DRIVE_THROUGH أو HAPPY_HOUR أو DELIVERY أو TAKEOUT أو KITCHEN أو BREAKFAST أو LUNCH أو DINNER أو BRUNCH أو PICKUP أو SENIOR_HOURS). يتم ضبطها للسمة secondary_opening_hours فقط.

اختياري Array<string>

مصفوفة من السلاسل تصف ساعات عمل المكان بنص يمكن لشخص عادي قراءته

PlaceOpeningHoursPeriod

الحقل مطلوب النوع الوصف
مطلوب PlaceOpeningHoursPeriodDetail

تحتوي على زوج من عناصر اليوم والوقت التي تصف وقت فتح المكان.

لمزيد من المعلومات، اطّلِع على PlaceOpeningHoursPeriodDetail.

اختياري PlaceOpeningHoursPeriodDetail

قد يحتوي على زوج من عناصر اليوم والوقت التي تصف وقت إغلاق المكان. إذا كان المكان مفتوحًا دائمًا، لن يتضمّن الردّ قسم الإغلاق. يمكن للعملاء الاعتماد على تمثيل ساعات العمل المفتوحة دائمًا كفترة مفتوحة تحتوي على يوم بقيمة 0 ووقت بقيمة 0000، وبدون close.

لمزيد من المعلومات، اطّلِع على PlaceOpeningHoursPeriodDetail.

PlaceSpecialDay

الحقل مطلوب النوع الوصف
اختياري سلسلة

تمثّل هذه السمة تاريخًا بتنسيق RFC3339 في المنطقة الزمنية المحلية للمكان، مثلاً ‎2010-12-31.

اختياري قيمة منطقية

تكون القيمة "صحيح" إذا كانت هناك ساعات عمل استثنائية لهذا اليوم. إذا كانت القيمة true، يعني ذلك أنّ هناك استثناءً واحدًا على الأقل لهذا اليوم. تؤدي الاستثناءات إلى ظهور قيم مختلفة في الحقول الفرعية لـ current_opening_hours وsecondary_opening_hours، مثل periods وweekday_text وopen_now. تنطبق الاستثناءات على الساعات، ويتم استخدام الساعات لإنشاء الحقول الأخرى.

PlaceOpeningHoursPeriodDetail

الحقل مطلوب النوع الوصف
مطلوب الرقم

رقم من 0 إلى 6، يتوافق مع أيام الأسبوع، بدءًا من يوم الأحد. على سبيل المثال، يشير الرقم 2 إلى يوم الثلاثاء.

مطلوب سلسلة

قد يحتوي على وقت من اليوم بتنسيق hhmm بنظام 24 ساعة. وتتراوح القيم بين 0000 و2359. سيتم تسجيل الوقت حسب المنطقة الزمنية للمكان.

اختياري سلسلة

تمثّل هذه السمة تاريخًا بتنسيق RFC3339 في المنطقة الزمنية المحلية للمكان، مثلاً ‎2010-12-31.

اختياري قيمة منطقية

تكون القيمة "صحيح" إذا تم اقتطاع فترة معيّنة بسبب حدّ أقصى يبلغ سبعة أيام، حيث تبدأ الفترة قبل منتصف الليل في تاريخ الطلب و/أو تنتهي في منتصف الليل أو بعده في اليوم الأخير. تشير هذه السمة إلى أنّ فترة الفتح أو الإغلاق يمكن أن تمتد إلى ما بعد هذا الحدّ الأقصى البالغ سبعة أيام.

PlacePhoto

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

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

يمكنك الاطّلاع على صور الأماكن لمزيد من المعلومات.

الحقل مطلوب النوع الوصف
مطلوب الرقم

ارتفاع الصورة

مطلوب Array<string>

سمات HTML للصورة

مطلوب سلسلة

سلسلة تُستخدَم لتحديد الصورة عند تنفيذ طلب صورة.

مطلوب الرقم

عرض الصورة

PlaceReview

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

الحقل مطلوب النوع الوصف
مطلوب سلسلة

اسم المستخدم الذي أرسل المراجعة تتم إضافة المراجعات المجهولة المصدر إلى "مستخدم Google".

مطلوب الرقم

التقييم الإجمالي الذي قدّمه المستخدم لهذا المكان هذا عدد صحيح يتراوح بين 1 و5.

مطلوب سلسلة

تشير هذه السمة إلى وقت إرسال المراجعة في شكل نص، وذلك بالنسبة إلى الوقت الحالي.

مطلوب الرقم

وقت إرسال المراجعة، ويُقاس بعدد الثواني منذ منتصف ليل 1 يناير 1970 بالتوقيت العالمي المنسق.

اختياري سلسلة

عنوان URL للملف الشخصي الخاص بالمستخدم في برنامج "المرشدون المحليون" على "خرائط Google"، في حال توفّره

اختياري سلسلة

رمز لغة IETF يشير إلى لغة المراجعة التي تم عرضها.يحتوي هذا الحقل على علامة اللغة الرئيسية فقط، وليس العلامة الثانوية التي تشير إلى البلد أو المنطقة. على سبيل المثال، يتم وضع علامة &quot;en&quot; على جميع المراجعات باللغة الإنجليزية، وليس &quot;en-AU&quot; أو &quot;en-UK&quot; وما إلى ذلك.ويكون هذا الحقل فارغًا إذا كان هناك تقييم فقط بدون نص مراجعة.

اختياري سلسلة

رمز لغة IETF يشير إلى اللغة الأصلية للمراجعة. إذا تمت ترجمة المراجعة، تكون قيمة original_language مختلفة عن قيمة language.يحتوي هذا الحقل على علامة اللغة الرئيسية فقط، وليس العلامة الثانوية التي تشير إلى البلد أو المنطقة. على سبيل المثال، يتم وضع علامة "en" على جميع المراجعات باللغة الإنجليزية، وليس "en-AU" أو "en-UK" وما إلى ذلك.ويكون هذا الحقل فارغًا إذا كان هناك تقييم فقط بدون نص مراجعة.

اختياري سلسلة

عنوان URL لصورة الملف الشخصي للمستخدم، إذا كانت متوفّرة

اختياري سلسلة

مراجعة المستخدم عند مراجعة موقع جغرافي باستخدام "أماكن Google"، تُعتبر المراجعات النصية اختيارية. لذلك، قد يكون هذا الحقل فارغًا. يُرجى العِلم أنّ هذا الحقل قد يتضمّن ترميز HTML أساسي. على سبيل المثال، قد يمثّل مرجع الكيان &amp; علامة العطف (&).

اختياري قيمة منطقية

قيمة منطقية تشير إلى ما إذا كانت المراجعة مترجَمة من اللغة الأصلية التي كُتبت بها.إذا تمت ترجمة مراجعة، ما يتوافق مع القيمة &quot;صحيح&quot;، تنصحك Google بالإشارة إلى ذلك للمستخدمين. على سبيل المثال، يمكنك إضافة السلسلة التالية إلى المراجعة: "تمت الترجمة من خلال Google".