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

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

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

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

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

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

• أجهزة Android: انتقِل إلى Places SDK for Android وواجهات برمجة التطبيقات الخاصة بالموقع الجغرافي على Android.

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

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

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

السبب	النطاق	رمز حالة 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 صالحًا. راجِع قسم نص الطلب للحصول على تفاصيل حول كل حقل.