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

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

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

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

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

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

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

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