الأسئلة الشائعة عن خدمة الأماكن على الويب

يحتوي هذا المستند على إجابات عن الأسئلة الشائعة حول واجهة برمجة التطبيقات Places API. إذا لم تتمكّن من العثور على إجابة عن سؤالك هنا، قد تكون بعض الصفحات التالية مفيدة لك.

تضمّ Places API أيضًا منتدى مطوّرين نشطًا. إذا كانت لديك أسئلة حول الرمز، ننصحك بنشر سؤالك في المنتدى. يمكنك الاطّلاع على مزيد من المعلومات حول طرح الأسئلة في صفحة الدعم.

البحث عن الأماكن

لماذا لا يتم عرض بعض الأماكن عند الفلترة حسب النوع؟

من المحتمل أنّه لم يتم تصنيف المكان الذي تبحث عنه بعد. يتم تصنيف جميع الأماكن على أنّها من النوع العام "establishment" إلى أن تحصل Google على بيانات كافية عن مكان ما لتصنيفه على أنّه أحد أنواع الأماكن المتوافقة.

كحل بديل، يمكنك تمرير المكان type إلى المَعلمة keyword. تتم مطابقة المَعلمة keyword مع: الاسم والنوع والعنوان ومراجعات العملاء.

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

لماذا لا يتم عرض بعض الأماكن المجاورة؟

بشكلٍ تلقائي، ترتّب Places API النتائج حسب prominence ضمن radius المقدَّمة. يمكن أن يعرض طلب بحث بالقرب منك ما يصل إلى 60 نتيجة، مقسمة على ثلاث صفحات. إذا كان ترتيب مكان ما هو 22 في prominence، سيظهر في الصفحة الثانية من النتائج التي يمكنك الوصول إليها من خلال التنقّل. إذا كان ترتيب مكان ما أعلى من المركز 60 في prominence، لن يتم تضمينه في نتيجة البحث، حتى إذا كان أقرب إلى مركز البحث.

يمكنك ترتيب نتائجك حسب distance بدلاً من prominence من خلال ضبط المَعلمة rankby في طلب البحث على distance وحذف المَعلمةradius. سيتم تجاهل مدى الصلة وعرض الأماكن حسب المسافة من location.

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

لماذا أتلقّى نتيجتين كحد أقصى عند الفلترة حسب بعض types؟

تم تصميم Places API لعرض قائمة بنتائج establishments (أيّ عنصر من الجدول الأول في أنواع الأماكن المتوافقة) وموقعَين جغرافيَّين (أيّ عنصر من الجدول الثاني في أنواع الأماكن المتوافقة) بالقرب منك للمساعدة في تحديد المنطقة التي تريد تنفيذ طلب بحث بالقرب منك فيها.

سيؤدي فلترة طلب البحث عن الأماكن القريبة حسب موقع جغرافي type، مثل locality أو political، إلى استبعاد نتائج establishment.

بيانات المكان

كيف يمكنني إضافة أماكن أو تعديلها؟

إذا كنت مالكًا لنشاط تجاري، يمكنك إضافة بطاقات بيانات نشاطك التجاري وإثبات ملكيتها وإدارتها على "خرائط Google" باستخدام الملف التجاري.

إذا لم تكن تملك المكان، يبقى بإمكانك اقتراح تغييرات.

تحديد المشاكل وحلّها

لماذا أتلقّى باستمرار الحالة "REQUEST_DENIED"؟

تعرض Places API القيمة "status": "REQUEST_DENIED" في الحالات التالية:

  • لم تفعِّل Places API في وحدة تحكّم Google Cloud.
  • لا تتوفّر المَعلمة key في طلبك.
  • لا تتطابق المَعلمة key مع مفتاح واجهة برمجة التطبيقات في وحدة تحكّم Google Cloud.
  • لم يتم إعداد مفتاح واجهة برمجة التطبيقات بشكل صحيح في وحدة تحكّم Google Cloud:
    • إذا كنت تستخدم مفتاح واجهة برمجة تطبيقات مخصّصًا لمتصفّح معيّن، تأكَّد من صحة المُحيلِين المسموح بهم.
    • إذا كنت تستخدم مفتاح واجهة برمجة تطبيقات مخصّصًا لخادم معيّن، تأكَّد من صحة عناوين IP المسموح بها.
    • لا تتوفّر مفاتيح واجهة برمجة التطبيقات التي تتضمّن قيودًا على Android أو iOS. استخدِم مفتاح واجهة برمجة التطبيقات (API) عامًا (غير مقيد) أو مفتاحًا يحتوي على قيود للمتصفّح أو الخادم.
  • لم يتم إرسال الطلب كطلب HTTPS، علمًا بأنّ HTTPS مطلوب لجميع طلبات Places API.
  • تم استخدام HTTP method غير صحيح لإرسال الطلب.