إليك بعض النصائح حول تحديد المشاكل الشائعة وحلّها.
لماذا يكون نصف قطر الدقة كبيرًا جدًا؟
إذا كانت استجابة الموقع الجغرافي تظهر قيمة عالية جدًا في حقل الدقة، فإن تحديد الموقع الجغرافي بناءً على عنوان 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) وواجهات برمجة التطبيقات التالية:
أجهزة Android: انتقِل إلى حزمة تطوير البرامج للأماكن لأجهزة Android وAndroid واجهات برمجة التطبيقات للمواقع الجغرافية:
أجهزة 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 صالحًا. ارجع إلى قسم نص الطلب للاطّلاع على تفاصيل حول كل . |