في ما يلي بعض النصائح حول تحديد المشاكل الشائعة وحلّها.
لماذا يكون نطاق الدقة كبيرًا جدًا؟
إذا كان ردّ الموقع الجغرافي يعرض قيمة عالية جدًا في حقل الدقة، قد تحدد الخدمة الموقع الجغرافي استنادًا إلى عنوان IP للطلب، بدلاً من نقاط WiFi أو أبراج الاتصالات. يمكن أن تحدث هذه الأنواع من الردود إذا لم تتمكّن الخدمة من التعرّف على أي أبراج خلوية أو نقاط وصول.
للتأكّد من أنّ الخدمة لم تتمكّن من تحديد الموقع الجغرافي لنقاط الوصول، اضبط
considerIp
على false في طلبك. إذا كان الردّ هو 404، يعني ذلك أنّه
تأكّدت من أنّه لا يمكن تحديد الموقع الجغرافي لعنصرَي wifiAccessPoints وcellTowers.
كيف يمكنني تحديد المشاكل وحلّها في ما يتعلّق بخطأ في الاستجابة؟
إذا أدّى طلبك إلى حدوث خطأ، يعرض النظام تنسيقًا عاديًا لنص الاستجابة ويضبط رمز حالة HTTP على حالة خطأ.
يحتوي ردّ الخطأ على عنصر يتضمّن عنصر خطأ واحدًا بالمفتاحين التاليين:
code
: هذا الرمز هو نفسه حالة HTTP للاستجابة.message
: وصف موجز للخطأerrors
: قائمة بالأخطاء التي حدثت يحتوي كل خطأ على معرّف لنوع الخطأ (السبب) ووصف موجز (الرسالة).
على سبيل المثال، يؤدي إرسال ملف JSON غير صالح إلى ظهور الخطأ التالي:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "parseError",
"message": "Parse Error",
}
],
"code": 400,
"message": "Parse Error"
}
}
جمع معلومات الاختبار من الأجهزة
لإجراء اختبار إضافي، يمكنك جمع المعلومات من جهازك باستخدام حِزم تطوير البرامج (SDK) وواجهات برمجة التطبيقات التالية:
أجهزة Android: انتقِل إلى حزمة تطوير البرامج (SDK) لتطبيق "الأماكن" على Android وواجهات برمجة التطبيقات لنظام تحديد الموقع الجغرافي على Android.
أجهزة iOS: انتقِل إلى حزمة تطوير البرامج (SDK) لتطبيق "الأماكن" لنظام التشغيل iOS.
أوصاف الأخطاء
في ما يلي الأخطاء المحتملة التي قد تواجهها في الأوصاف.
السبب | النطاق | رمز حالة HTTP | الوصف |
---|---|---|---|
dailyLimitExceeded |
usageLimits |
403 | لقد تجاوزت الحدّ اليومي. |
keyInvalid |
usageLimits |
400 | مفتاح واجهة برمجة التطبيقات غير صالح لواجهة برمجة التطبيقات Geolocation API. يُرجى التأكّد من أنّك أدرجت المفتاح بالكامل، وأنّك اشتريت واجهة برمجة التطبيقات أو فعّلت نظام الفوترة وواجهة برمجة التطبيقات للحصول على الحصة بدون أي رسوم. |
userRateLimitExceeded |
usageLimits |
403 | لقد تجاوزت الحد الأقصى للطلبات الذي ضبطته في وحدة تحكّم Google Cloud. يتم عادةً ضبط هذا الحدّ على أنّه عدد الطلبات في اليوم وعدد الطلبات كل 100 ثانية وعدد الطلبات كل 100 ثانية لكل مستخدم. يجب ضبط الحدّ الأقصى لمنع مستخدم واحد أو مجموعة صغيرة من المستخدمين من استنفاد حصتك اليومية، مع السماح بالوصول المعقول لجميع المستخدمين. اطّلِع على وضع حدود لاستخدام واجهة برمجة التطبيقات لضبط هذه الحدود. |
notFound |
geolocation |
404 | كان الطلب صالحًا، ولكن لم يتم عرض أي نتائج. |
parseError |
global |
400 | نص الطلب ليس بتنسيق JSON صالح. يُرجى الرجوع إلى القسم Request Body (نص الطلب) للاطّلاع على تفاصيل حول كل حقل. |