العثور على مكان (الإصدار القديم)

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

إذا كان عنوان إرسال الفواتير الخاص بك يقع في المنطقة الاقتصادية الأوروبية، ستسري بنود خدمة "منصة خرائط Google" في المنطقة الاقتصادية الأوروبية على استخدامك للخدمات اعتبارًا من 8 تموز (يوليو) 2025. تختلف الوظائف حسب المنطقة. مزيد من المعلومات

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

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

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

يتلقّى طلب العثور على مكان (الإصدار القديم) إدخالاً نصيًا ويعرض مكانًا. يمكن أن يكون الإدخال أي نوع من البيانات النصية في "خرائط Google"، مثل الاسم أو العنوان أو رقم الهاتف. يجب أن يكون الطلب سلسلة. يؤدي طلب Find Place (Legacy) الذي يستخدم بيانات غير نصية، مثل إحداثيات خطوط الطول والعرض أو رمز موقع مفتوح، إلى حدوث خطأ.

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

طلبات Find Place (القديمة)

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

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

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

• json (موصى به) يشير إلى الإخراج بتنسيق JavaScript Object Notation ‏ (JSON)
• يشير xml إلى الناتج بتنسيق XML

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

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

• إدخال

  سلسلة النص المطلوب البحث عنها. يجب أن يكون هذا الحقل اسم مكان أو عنوانًا أو رقم هاتف (مثلاً، "123 شارع رئيسي" أو "دار البلدية").

  ملاحظة مهمة: يجب أن تكون قيمة input سلسلة. يؤدي طلب Find Place (الإصدار القديم) باستخدام بيانات غير نصية، مثل إحداثيات خطوط الطول والعرض أو رمز موقع مفتوح، إلى حدوث خطأ.

• inputtype

  نوع الإدخال يمكن أن يكون هذا الرمز إما textquery أو phonenumber. يجب أن تكون أرقام الهواتف بالتنسيق الدولي (تبدأ بعلامة زائد ("+")، متبوعة برمز البلد، ثم رقم الهاتف نفسه). يمكنك الاطّلاع على توصية الاتحاد الدولي للاتصالات بشأن معيار E.164 لمزيد من المعلومات.

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

• fields

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

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

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

  أساسية

  تتضمّن فئة "أساسية" الحقول التالية: address_components وadr_address وbusiness_status وformatted_address وgeometry وicon وicon_mask_base_uri وicon_background_color وname وpermanently_closed (متوقّف نهائيًا) وphoto وplace_id وplus_code وtype وurl وutc_offset وvicinity وwheelchair_accessible_entrance.

  التواصل

  تتضمّن فئة "جهة الاتصال" الحقول التالية: current_opening_hours وformatted_phone_number وinternational_phone_number وopening_hours وsecondary_opening_hours وwebsite

  الأجواء

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

• locationbias

  تفضيل النتائج في منطقة محدّدة، وذلك من خلال تحديد إما نصف قطر بالإضافة إلى خطوط الطول والعرض، أو زوجَين من خطوط الطول والعرض يمثّلان نقاط المستطيل في حال عدم تحديد هذه المَعلمة، تستخدم واجهة برمجة التطبيقات ميزة "تفضيل عنوان IP" تلقائيًا.

  • تحيز عنوان IP: يوجّه واجهة برمجة التطبيقات إلى استخدام التحيز في عناوين IP. مرِّر السلسلة ipbias (لا يتضمّن هذا الخيار أي مَعلمات إضافية).
  • دائري: سلسلة تحدّد نصف القطر بالأمتار، بالإضافة إلى خطوط الطول والعرض بالدرجات العشرية استخدِم التنسيق التالي: circle:radius@lat,lng.
  • مستطيل: سلسلة تحدّد زوجَين من خطوط الطول والعرض بالدرجات العشرية، تمثّل النقطتَين الجنوبية الغربية والشمالية الشرقية للمستطيل. استخدِم التنسيق التالي:rectangle:south,west|north,east. يُرجى العِلم أنّه يتم تقريب قيم الشرق/الغرب إلى النطاق -180، 180، ويتم تثبيت قيم الشمال/الجنوب ضمن النطاق -90، 90.

ملاحظة: إذا حذفت المَعلمة fields من طلب العثور على مكان (Legacy)، سيتم عرض place_id للنتيجة فقط.

أمثلة على العثور على مكان (الإصدار القديم)

يعرض المثال التالي طلبًا من العثور على مكان (الإصدار القديم) بشأن "متحف الفن المعاصر في أستراليا"، بما في ذلك الحقول photos وformatted_address وname وrating وopening_hours وgeometry:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

يعرض المثال التالي طلبًا إلى العثور على مكان (الإصدار القديم) بشأن "مطعم Mongolian Grill"، باستخدام المَعلمة locationbias لتفضيل النتائج التي تقع ضمن 2,000 متر من الإحداثيات المحدّدة:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

يعرض المثال التالي طلب العثور على مكان (قديم) للحصول على رقم هاتف. يُرجى العِلم أنّه تم ترميز بادئة المكالمة الدولية "+" إلى %2B لكي يكون هذا الطلب عنوان URL متوافقًا. إذا لم يتم ترميز البادئة +، سيتم فك ترميزها إلى مسافة على الخادم، ما يؤدي إلى بحث غير صالح عن رقم الهاتف.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

ردود العثور على مكان (الإصدار القديم)

لا تحتوي استجابة Find Place (Legacy) إلا على أنواع البيانات التي تم تحديدها باستخدام المَعلمة fields، بالإضافة إلى html_attributions. يعرض المثال التالي الردّ على طلب العثور على مكان (قديم) بشأن "متحف الفن المعاصر في أستراليا"، بما في ذلك الحقول formatted_address وgeometry وname وopening_hours وphotos وrating.

JSON

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}    

XML

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

    

PlacesFindPlaceFromTextResponse

الحقل	مطلوب	النوع	الوصف
candidates	مطلوب	Array<Place>	يحتوي على مصفوفة من الأماكن المرشَّحة. تعرض طلبات البحث عن الأماكن (الإصدار القديم) مجموعة فرعية من الحقول التي تعرضها طلبات تفاصيل المكان (الإصدار القديم). إذا لم يتم عرض الحقل الذي تريده من خلال خدمة &quot;البحث عن الأماكن&quot; (الإصدار القديم)، يمكنك استخدام خدمة &quot;البحث عن الأماكن&quot; (الإصدار القديم) للحصول على رقم تعريف المكان، ثم استخدام رقم تعريف المكان هذا لإجراء طلب &quot;تفاصيل المكان&quot; (الإصدار القديم). اطّلِع على مكان لمزيد من المعلومات.
status	مطلوب	PlacesSearchStatus	يحتوي على حالة الطلب، وقد يتضمّن معلومات تصحيح الأخطاء لمساعدتك في معرفة سبب تعذُّر تلبية الطلب. يُرجى الاطّلاع على PlacesSearchStatus لمزيد من المعلومات.
error_message	اختياري	سلسلة	عندما تعرض الخدمة رمز حالة غير OK<، قد يكون هناك حقل error_message إضافي ضمن عنصر الاستجابة. يحتوي هذا الحقل على معلومات أكثر تفصيلاً حول أسباب رمز الحالة المحدّد. لا يتم عرض هذا الحقل دائمًا، وقد يتغيّر محتواه.
info_messages	اختياري	Array<string>	عندما تعرض الخدمة معلومات إضافية حول مواصفات الطلب، قد يكون هناك حقل info_messages إضافي ضمن عنصر الردّ. لا يتم عرض هذا الحقل إلا للطلبات الناجحة. وقد لا يتم عرضها دائمًا، كما أنّ محتواها قابل للتغيير.

PlacesSearchStatus

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

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

المكان

السمات التي تصف مكانًا لن تتوفّر بعض السمات لبعض أنواع الأماكن.

الحقل	مطلوب	النوع	الوصف
address_components	اختياري	Array<AddressComponent>	تمثّل هذه السمة مصفوفة تحتوي على المكوّنات المنفصلة التي تنطبق على هذا العنوان. يمكنك الاطّلاع على AddressComponent لمزيد من المعلومات.
adr_address	اختياري	سلسلة	تمثّل هذه السمة عنوان المكان بتنسيق adr microformat.
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	اختياري	سلسلة	تحتوي هذه السمة على رمز اللون السداسي العشري التلقائي لفئة المكان.
icon_mask_base_uri	اختياري	سلسلة	يحتوي على عنوان URL لرمز مقترَح، باستثناء امتداد نوع الملف .svg أو .png.
international_phone_number	اختياري	سلسلة	يحتوي على رقم الهاتف الخاص بالمكان بالتنسيق الدولي. يتضمّن التنسيق الدولي رمز البلد، ويسبقه الرمز + (علامة الجمع). على سبيل المثال، international_phone_number لمكتب Google في سيدني، أستراليا هو [phone].
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 Codes كبديل لعناوين الشوارع في الأماكن التي لا تتوفّر فيها (حيث لا يتم ترقيم المباني أو تسمية الشوارع). يمكنك الاطّلاع على Open Location Code ورموز Plus Codes. يمكنك الاطّلاع على PlusCode لمزيد من المعلومات.
price_level	اختياري	الرقم	مستوى سعر المكان، على مقياس من 0 إلى 4 سيختلف المبلغ الدقيق الذي تشير إليه قيمة معيّنة من منطقة إلى أخرى. يتم تفسير مستويات الأسعار على النحو التالي: ‫0 مجاني 1 Inexpensive ‫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" إلى المراجعة.