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

في ما يلي بعض النصائح لتحديد المشاكل الشائعة وحلّها.

لماذا نصف قطر الدقة كبير جدًا؟

إذا أظهر ردّ تحديد الموقع الجغرافي قيمة عالية جدًا في حقل الدقة، قد تكون الخدمة تحدّد الموقع الجغرافي استنادًا إلى عنوان 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"
 }
}

جمع معلومات الاختبار من الأجهزة

لإجراء اختبارات إضافية، يمكنك جمع معلومات من جهازك باستخدام حِزم تطوير البرامج وواجهات برمجة التطبيقات التالية:

أوصاف الأخطاء

في ما يلي الأخطاء المحتملة التي قد تواجهها مع أوصافها.

السبب النطاق رمز حالة HTTP الوصف
dailyLimitExceeded usageLimits 403 لقد تجاوزت الحد اليومي.
keyInvalid usageLimits 400 مفتاح واجهة برمجة التطبيقات غير صالح لواجهة برمجة التطبيقات Geolocation API. احرص على تضمين المفتاح بالكامل، وتأكَّد من أنّك اشتريت واجهة برمجة التطبيقات أو فعّلت الفوترة ونشّطت واجهة برمجة التطبيقات للحصول على الحصة بدون أي تكلفة.
userRateLimitExceeded usageLimits 403 لقد تجاوزت الحدّ الأقصى للطلبات الذي ضبطته في Google Cloud Console. يتم عادةً ضبط هذا الحد كطلبات في اليوم، وطلبات كل 100 ثانية، وطلبات كل 100 ثانية لكل مستخدم. عليك ضبط الحد الأقصى لمنع مستخدم واحد أو مجموعة صغيرة من المستخدمين من استنفاد الحصة اليومية، مع السماح لجميع المستخدمين بالوصول بشكل معقول. راجِع استخدام واجهة برمجة التطبيقات Capping API لضبط هذه الحدود.
notFound geolocation 404 كان الطلب صالحًا، ولكن لم يتم عرض أي نتائج.
parseError global 400 نص الطلب ليس JSON صالحًا. راجِع قسم نص الطلب للحصول على تفاصيل حول كل حقل.