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

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

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

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

عرض بيانات خطأ

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

required

يفتقد طلبك معلمة عنوان URL. لاحظ أن رسالة الخطأ تشير إلى المَعلمة المفقودة

notFound، invalid

إنّ x أو y أو تقع قيم z خارج النطاق.

• بالنسبة لمربعات الخرائط العادية، يعتمد الحد الأقصى لمستوى التكبير على مربع الخريطة، وعلى خيارات الخريطة التي طلبتها.

• بالنسبة لمربعات الخرائط العادية، يجب أن يكون الإحداثي x ضمن النطاق [0، (2^zoom)-1].

• بالنسبة لمربعات الخرائط العادية، يجب أن يكون الإحداثي ص ضمن النطاق [0, (2^(zoom-1))-1].

• بالنسبة إلى مربّعات "التجوّل الافتراضي"، يجب أن يكون التكبير أو التصغير بين صفر وخمسة، بشكل شامل.

• بالنسبة إلى مربعات التجوّل الافتراضي، يكون نطاقا الإحداثيين x وy متماثلين لمربعات الخرائط العادية، حتى المستوى الخامس من التكبير. في هذه المرحلة، يكون الحد الأقصى القيمتان imageHeight أو imagewidth مقسومًا على tileHeight أو tileWidth

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

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

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

مربّعات ثلاثية الأبعاد

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

أخطاء عارض المربّعات

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

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

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

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

400: وسيطة غير صالحة

مفاتيح واجهة برمجة التطبيقات أو معلَمات طلب البحث أو أرقام تعريف المربّعات/مجموعات المربّعات أو جلسة منتهية الصلاحية غير صالحة الرمز المميّز.

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

مفتاح واجهة برمجة التطبيقات مفقود أو اتصال طبقة المقابس الآمنة غير متوفر أو لم تتم إضافة مفتاح واجهة برمجة التطبيقات إلى القائمة المسموح بها للمربعات الثلاثية الأبعاد. التواصل مع Google الحصول على الدعم باستخدام رقم تعريف مشروعك لإضافته إلى القائمة المسموح بها الخاصة بوظيفة "المربّعات الثلاثية الأبعاد" في واجهة برمجة التطبيقات Map Tiles API

429: عدد كبير جدًا من الطلبات

تم استنفاد حصتك. معلومات التواصل فريق الدعم في Google لزيادة حصتك.