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

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

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

إذا كان ردّ الموقع الجغرافي يعرض قيمة عالية جدًا في حقل الدقة، قد تحدد الخدمة الموقع الجغرافي استنادًا إلى عنوان 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) وواجهات برمجة التطبيقات التالية:

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

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

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