يتضمّن هذا المستند إجابات عن الأسئلة الشائعة حول Places API. إذا لم تتمكّن من العثور على إجابة لسؤالك هنا، قد تجد بعض الصفحات التالية مفيدة.
- الأسئلة الشائعة حول المطوّرين في "خرائط Google"
- بنود خدمة "منصة خرائط Google"
- سياسات المطوّرين في 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 Console.
- المَعلمة
key
غير متوفّرة في طلبك. - لا تتطابق المَعلمة
key
مع مفتاح واجهة برمجة التطبيقات في وحدة تحكّم Google Cloud. - لم يتم إعداد مفتاح واجهة برمجة التطبيقات بشكل صحيح في وحدة تحكّم Google Cloud:
- إذا كنت تستخدم مفتاح API محصورًا بالمتصفّح، تأكَّد من صحة عناوين URL المسموح بها.
- إذا كنت تستخدم مفتاح واجهة برمجة تطبيقات محددًا بخادم، تأكَّد من صحة عناوين IP المسموح بها.
- لا تتوافق مفاتيح واجهة برمجة التطبيقات مع قيود Android أو iOS. استخدِم مفتاح API عامًا (غير مقيّد) أو مفتاحًا يتضمّن قيودًا على المتصفّح أو الخادم.
- لم يتم إرسال الطلب كطلب
HTTPS
، علمًا بأنّHTTPS
مطلوب لجميع طلبات Places API. - تم استخدام
HTTP method
غير صحيح لإرسال الطلب.