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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • لم تفعِّل واجهة Places API في Google Cloud Console.
  • المعلمة key غير متوفرة في طلبك.
  • لا تتطابق مَعلمة key مع مفتاح واجهة برمجة التطبيقات في Google Cloud Console.
  • لم يتم إعداد مفتاح واجهة برمجة التطبيقات بشكل صحيح في Google Cloud Console:
    • في حال استخدام مفتاح واجهة برمجة تطبيقات تم حظره من خلال المتصفّح، يُرجى التأكّد من صحة المُحيلين المسموح بهم.
    • إذا كنت تستخدم مفتاح واجهة برمجة تطبيقات مقيدًا بواسطة الخادم، تأكَّد من صحة عناوين IP المسموح بها.
    • لا يمكن استخدام مفاتيح واجهة برمجة التطبيقات التي تفرض قيودًا على أجهزة Android أو iOS. يُرجى استخدام مفتاح واجهة برمجة تطبيقات عام (غير محدود) أو مفتاح يتضمّن قيودًا على المتصفّح أو الخادم.
  • لم يتم إرسال الطلب كطلب HTTPS، لأنّ السمة HTTPS مطلوبة لجميع طلبات بيانات Places API.
  • تم استخدام عنوان HTTP method غير الصحيح لإرسال الطلب:
    • يجب إرسال جميع الطلبات كطلب GET باستثناء [Place Add][place-add].
    • يجب إرسال جميع طلبات [Place Add][place-add] كطلب POST.