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

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

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

إذا كانت استجابة رصد الموقع الجغرافي تظهر قيمة عالية جدًا في حقل الدقة، قد يتم تحديد الموقع الجغرافي للخدمة استنادًا إلى عنوان 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: انتقِل إلى Places SDK for Android وAndroid Location APIs.

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

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

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

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