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

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

تضم 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 لجميع الطلبات. طلبات واجهة برمجة تطبيقات الأماكن.
  • تم استخدام HTTP method غير الصحيح لإرسال الطلب:
    • يجب إرسال جميع الطلبات كطلبات GET باستثناء [إضافة مكان][إضافة مكان]
    • يجب إرسال جميع طلبات [إضافة مكان][place-add] في شكل طلب POST.