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

مطوّرو المنطقة الاقتصادية الأوروبية

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

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

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

حدث خطأ أثناء عرض القائمة.

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

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

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

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

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

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

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

  • بالنسبة إلى مربّعات Street View، تكون نطاقات الإحداثيات 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، عليك إعادة محاولة تنفيذ الطلب بطريقة لا تؤدي إلى إغراق خوادم Google بالطلبات المعطّلة أو الأخطاء الواسعة النطاق، لأنّ العديد من العملاء يحاولون إعادة تنفيذ الطلبات بشكل متسلسل وسريع. وهذا يعني استخدام الرقود الأسي الثنائي عند إعادة محاولة إرسال طلباتك. يفرض التراجع الأسي عليك توزيع طلباتك على مدار الوقت، وذلك لإتاحة الوقت للخادم كي يستعيد عافيته.

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

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

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

أخطاء في أداة عرض المربّعات

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

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

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

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

‫400: وسيطة غير صالحة
مفاتيح واجهة برمجة التطبيقات أو مَعلمات طلب البحث أو معرّفات المربّعات/مجموعات المربّعات غير صالحة، أو انتهاء صلاحية رمز الجلسة المميز
‫403: تم رفض منح الإذن
مفتاح واجهة برمجة التطبيقات غير متوفّر أو اتصال SSL غير متوفّر أو لم تتم إضافة مفتاح واجهة برمجة التطبيقات إلى القائمة المسموح بها لـ 3D Tiles. يُرجى التواصل مع فريق الدعم في Google وإرسال رقم تعريف مشروعك ليتم إضافتك إلى
القائمة المسموح بها لاستخدام وظيفة 3D Tiles في Map Tiles API.
‫429: عدد كبير جدًا من الطلبات
تم استنفاد حصتك. يُرجى التواصل مع فريق الدعم في Google لزيادة حصتك.