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

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

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

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

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

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

توضّح القائمة التالية الأخطاء التي قد تواجهها عند استخدام 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:

الأسباب المحتملة:

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

  • الرسالة: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

    لا تتوفّر مربّعات الأقمار الصناعية الثنائية الأبعاد في المشاريع المرتبطة بحساب فوترة يتضمّن عنوانًا في المنطقة الاقتصادية الأوروبية. لمزيد من المعلومات، يُرجى الاطّلاع على تعديلات على Map Tiles API للعملاء في المنطقة الاقتصادية الأوروبية.

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: وسيطة غير صالحة
مفاتيح واجهة برمجة التطبيقات أو مَعلمات طلب البحث أو معرّفات المربّعات أو مجموعات المربّعات غير صالحة، أو رمز مميّز لجلسة منتهية الصلاحية
‫400: قيمة غير صالحة
تأكَّد من أنّ mapType الذي تم إرسال طلب createSessionToken به يطابق mapType المستخدَم في نقطة نهاية المربّعات اللاحقة. على سبيل المثال، لا يمكن استخدام رمز مميّز لجلسة streetview لطلب مربّع roadmap.

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

الأسباب المحتملة:

  • مفتاح واجهة برمجة التطبيقات غير متوفّر أو اتصال SSL غير متوفّر أو لم تتم إضافة مفتاح واجهة برمجة التطبيقات إلى قائمة السماح لـ 3D Tiles. يُرجى التواصل مع فريق الدعم في Google وإرسال رقم تعريف مشروعك ليتم إضافتك إلى القائمة المسموح بها لاستخدام وظيفة 3D Tiles في Map Tiles API.

  • الرسالة: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

    لا تتوفّر مربّعات ثلاثية الأبعاد واقعية في المشاريع المرتبطة بحساب فوترة يتضمّن عنوانًا في المنطقة الاقتصادية الأوروبية. لمزيد من المعلومات، يُرجى الاطّلاع على تعديلات على Map Tiles API للعملاء في المنطقة الاقتصادية الأوروبية.

‫429: عدد كبير جدًا من الطلبات
تم استنفاد حصتك. يُرجى التواصل مع فريق الدعم في Google لزيادة حصتك.