معالجة الأخطاء

بعد تقديم طلب، قد تتلقّى ردًا يحتوي على تفاصيل الخطأ.

مربّعات ثنائية الأبعاد وصور "التجوّل الافتراضي"

توضِّح القائمة التالية الأخطاء التي قد تواجهها عند استخدام "المربّعات الثنائية الأبعاد" و"التجوّل الافتراضي".

خطأ في البيانات

توضّح القائمة التالية الأخطاء التي قد تواجهها عند استخدام واجهة برمجة تطبيقات Map Tiles.

required

لا يتضمّن طلبك معلَمة عنوان URL. يُرجى العلم أنّ رسالة الخطأ تشير إلى المَعلمة غير المتوفّرة.

notFound، invalid

القيم x أو y أو z خارج النطاق.

• بالنسبة إلى مربّعات الخرائط العادية، يعتمد الحد الأقصى لمستوى التكبير/التصغير على مربّع الخريطة المحدَّد وعلى خيارات الخريطة التي طلبتها.

• بالنسبة إلى مربّعات الخرائط العادية، يجب أن يكون الإحداثي x ضمن النطاق [0, (2^zoom)-1].

• بالنسبة إلى مربّعات الخرائط العادية، يجب أن يكون الإحداثي y ضمن النطاق [0, (2^(zoom-1))-1].

• بالنسبة إلى مربّعات التجوّل الافتراضي، يجب أن تكون قيمة التكبير أو التصغير بين صفر وخمسة، بشكل شامل.

• بالنسبة لمربعات التجول الافتراضي، يكون نطاقا الإحداثيات x وy متماثلين مع مربعات الخرائط العادية، حتى المستوى الخامس من التكبير. في هذه المرحلة، تكون القيم القصوى هي imageHeight أو imagewidth مقسومًا على tileHeight أو tileWidth.

forbidden: لا يتضمّن الطلب مفتاحًا صالحًا لواجهة برمجة التطبيقات.

expired

انتهت صلاحية رمزك المميّز session. ويكون الرمز المميز للجلسة صالحًا لمدة أسبوعين من وقت إنشائه لاحظ أن هذا قد يتغير دون إشعار. إذا ظهر لك هذا الخطأ، يجب الحصول على رمز مميَّز جديد للجلسة، كما هو موضّح في استخدام الرموز المميّزة للجلسة.

badRequest

تمت كتابة طلبك بشكل غير صحيح. يشمل السبب الشائع لذلك ما يلي:

• لقد حدّدت نوع خريطة terrain بدون تضمين طبقة roadmap.

• لقد تم تضمين مصفوفة styles لنوع خريطة غير خريطة طريق.

• لقد أرسلت قيمة خط العرض/خط الطول والعرض بالإضافة إلى رقم تعريف بانوراما في طلب البيانات الوصفية للتجوّل الافتراضي.

quotaExceeded، rateLimitExceeded

تجاوز تطبيقك الحصة المسموح بها أو تجاوزه المسموح به لعدد طلبات البحث في الثانية.

مثال على الخطأ

{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "errors": [
      {
        "message": "The request is missing a valid API key.",
        "domain": "global",
        "reason": "forbidden"
      }
    ],
    "status": "PERMISSION_DENIED"
  }
}

جارٍ إعادة محاولة إرسال الطلبات

عندما يتعذّر على الطلبات استخدام quotaExceeded وrateLimitExceeded، عليك إعادة محاولة تقديم طلبك، بحيث لا تغمر الطلبات المعطّلة أو عمليات الإخفاق على نطاق واسع خوادم Goodle، لأنّ العديد من العملاء يحاولون إعادة محاولة إرسال الطلبات بنجاح. هذا يعني استخدام خوارزمية الرقود الأسي الثنائي عند إعادة محاولة تنفيذ طلباتك. يفرض عليك "الرقود الأسي" أن تنشر طلباتك في الوقت المناسب لمنح الخادم وقتًا لاستردادها.

على سبيل المثال، إذا تعذّر طلب ما، يمكنك إعادة المحاولة بعد ثانية واحدة. ولكن إذا فشلت هذه المحاولة أيضًا، فحاول إعادة محاولة طلبك بعد ثانيتين. إذا فشل هذا الطلب أيضًا، فحاول مرة أخرى بعد أربع ثوانٍ. لذلك يمكنك نشر كل طلب متتابع بشكل فعال عن طريق مضاعفة المدة الزمنية بينهما.

مربّعات ثلاثية الأبعاد

قد لا تكون الأخطاء الواردة من خادم Google واضحة لك لأنك تصل إلى مربّعات صور واقعية من خلال عارض، يكون مسؤولًا عن التعامل مع أخطاء الخادم.

أخطاء عارض المربّعات

على سبيل المثال، يخفق عارض CesiumJS عادةً بدون تنبيه عند حدوث أخطاء في الخادم، ما قد يؤدي إلى حدوث أي عطل، بدءًا من الأعطال أو الشاشات الفارغة أو حتى عدم تحميل مربّعات معيّنة.

وتعتمد التقنية التي تستخدمها لتصحيح أخطاء الخادم على العارض المحدّد الذي تستخدمه. بالنسبة إلى برامج العرض المستندة إلى المتصفّح مثل CesiumJS، يمكنك فحص حركة بيانات الشبكة باستخدام أدوات مضمَّنة في معظم المتصفحات. على سبيل المثال، يمكنك استخدام أدوات مطوري البرامج في Chrome.

الأخطاء الشائعة

تحتوي القائمة التالية على تفاصيل حول الأخطاء الأكثر شيوعًا التي قد تواجهها.

400: الوسيطة غير صالحة

عدم صلاحية مفاتيح واجهة برمجة التطبيقات، أو معلَمات طلب البحث، أو أرقام تعريف المربّعات/مجموعة المربّعات، أو الرمز المميّز للجلسة المنتهية الصلاحية.

403: تم رفض الإذن.

لم تتم إضافة مفتاح واجهة برمجة التطبيقات المفقود أو اتصال طبقة المقابس الآمنة غير متوفّر أو مفتاح واجهة برمجة التطبيقات إلى القائمة المسموح بها للشاشات الثلاثية الأبعاد. يُرجى التواصل مع فريق دعم Google وإبلاغه برقم تعريف مشروعك لإضافتك إلى القائمة المسموح بها الخاصة بوظيفة المربّعات الثلاثية الأبعاد في واجهة برمجة تطبيقات مربّعات الخريطة.

429: عدد كبير جدًا من الطلبات

تم استنفاد حصتك. يمكنك التواصل مع فريق الدعم في Google لزيادة حصتك.