ندعوك للانضمام إلينا في يوم منتدى مطوّري "منصة خرائط Google" القادم في سان فرانسيسكو في ديسمبر. قدِّم طلبك الآن لحضور الفعالية.

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

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

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

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

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

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

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

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

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:

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

لا يتضمّن الطلب مفتاح واجهة برمجة تطبيقات صالحًا.
الرسالة: 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: تم رفض الإذن