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

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

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

إذا كان ردّ الموقع الجغرافي يعرض قيمة عالية جدًا في حقل الدقة، قد تحدد الخدمة الموقع الجغرافي استنادًا إلى عنوان IP للطلب، بدلاً من نقاط Wi-Fi أو أبراج الجيل الخلوي. يمكن أن تحدث هذه الأنواع من الردود إذا لم تتمكّن الخدمة من التعرّف على أي أبراج خلوية أو نقاط وصول.

للتأكّد من أنّ الخدمة لم تتمكّن من تحديد الموقع الجغرافي لنقاط الوصول، اضبط قيمة 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: انتقِل إلى حزمة تطوير برامج "الأماكن" لأجهزة Android وواجهات برمجة تطبيقات Android الموقع الجغرافي.

• أجهزة iOS: انتقِل إلى حزمة تطوير برامج "الأماكن" لأجهزة iOS.

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

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

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