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

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

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

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

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

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

قائمة الأخطاء

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

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

3D Tiles

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

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

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

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

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

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

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

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