Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

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

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

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

تتضمّن القائمة التالية تفاصيل الأخطاء التي قد تظهر لك عند استخدام 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: تم رفض الإذن