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: تم رفض الإذن