تحديد المشاكل وحلّها

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الأخطاء

في حالة حدوث خطأ، سيتم عرض نص استجابة التنسيق العادي، وسيتم تعيين رمز حالة HTTP على حالة الخطأ.

تتضمن الاستجابة كائنًا به كائن error واحد بالمفاتيح التالية:

  • code: هذه هي حالة HTTP نفسها للاستجابة.
  • message: وصف موجز للخطأ.
  • status: رمز حالة يشير إلى طبيعة الخطأ.

على سبيل المثال، سيؤدي إرسال معلمة placeId غير صالحة إلى عرض الخطأ التالي:

{
  "error": {
    "code": 400,
    "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"",
    "status": "INVALID_ARGUMENT"
  }
}

وتتضمن الأخطاء المحتملة ما يلي:

الرمز الحالة الرسالة تحديد المشاكل وحلّها
400 INVALID_ARGUMENT المفتاح الذي قدمته غير صالح. مفتاح واجهة برمجة التطبيقات غير صالح أو لم يتم تضمينه في الطلب. يُرجى التأكد من تضمين المفتاح بأكمله، ومن تفعيل واجهة برمجة التطبيقات لهذا المفتاح.
400 INVALID_ARGUMENT تحتوي معلمة "\"المسار\" على قيمة غير صالحة: ☃" يحتوي طلبك على وسيطات غير صالحة. في ما يلي الأسباب الأكثر احتمالاً لحدوث هذا الخطأ:
  • حدثت مشكلة في المعلمة path.
    يُرجى التأكّد من حصولك على نقطة واحدة على الأقل وأقل من 100 نقطة. يجب أن تكون كل نقطة زوجًا من الأرقام مفصولاً بفاصلة، مثل: 48.409114,-123.369158. ويجب فصل النقاط باستخدام أنبوب: "|".
  • تضمّن طلبك placeId غير صالح.
  • تضمّن طلبك كلاً من placeId وpath. يمكن تحديد معلمة واحدة فقط من هذه المعلمات لكل طلب.

لن يتم عرض هذا الخطأ إذا تم تمرير placeId إلى طريق لم يعد موجودًا، أو مكان ليس طريقًا.
403 PERMISSION_DENIED تم حظر الطلب غير المسجَّل. يُرجى الاشتراك باستخدام Google Developers Console. تم رفض الطلب لسبب واحد أو أكثر من الأسباب التالية:
  • مفتاح واجهة برمجة التطبيقات مفقود أو غير صالح.
  • الفوترة غير مفعّلة في حسابك.
  • تم تجاوز الحد الأقصى للاستخدام الذاتي.
  • لم تعد طريقة الدفع المقدمة صالحة (على سبيل المثال، انتهت صلاحية بطاقة الائتمان).

لاستخدام منتجات "منصة خرائط Google"، يجب تفعيل الفوترة في حسابك، ويجب أن تتضمّن جميع الطلبات مفتاح واجهة برمجة تطبيقات صالحًا. لإصلاح ذلك، اتّبِع الخطوات التالية:
404 NOT_FOUND HTTPS مطلوب لهذه الخدمة. تأكَّد من إرسال الطلبات إلى https://roads.googleapis.com/ وليس إلى http://roads.googleapis.com/.
429 RESOURCE_EXHAUSTED تمّ تقييد الطلب بسبب بلوغ حدود طلبات المشروع. لقد تجاوزت الحدّ الأقصى للطلبات الذي ضبطته في "وحدة تحكّم Google Cloud Platform". ويتم عادةً ضبط هذا الحدّ كطلبات في اليوم، وطلبات لكل 100 ثانية، وطلبات لكل 100 ثانية لكل مستخدم. يجب ضبط هذا الحدّ لمنع مجموعة واحدة أو صغيرة من المستخدمين من استهلاك حصتك اليومية، مع السماح في الوقت نفسه بوصول معقول لجميع المستخدمين. يُرجى الاطِّلاع على Capping API Usage (ضبط استخدام هذه الواجهات) لضبط هذه الحدود.

التراجع الأسي

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

الأسئلة الشائعة حول تحرّي الخلل وإصلاحه

مشاكل التنفيذ

ما معدّل التكرار الذي يجب أخذ عينة من موقع مركبتي فيه؟
يُوصى كل 1-10 ثوانٍ للحصول على نتائج عالية الجودة لسرعة على الطريق.
هل هناك حد لعدد النقاط التي يمكنني إرسالها لكل طلب بحث؟
نعم، يمكن أن يحتوي الطلب على 100 نقطة كحد أقصى.
ما مستوى الدقة الذي يجب استخدامه لتخزين أزواج خطوط الطول/العرض المقترنة؟
للتأكد من أن المسارات التي تم قطعها تتبع الطرق بجميع مستويات التكبير، حتى عند مستوى التكبير الأقصى، يجب عليك تخزين أزواج خطوط الطول وخطوط العرض في 7 أماكن عشرية بدقة.
هل يمكنني استخدام الخطوط المتعددة المشفّرة لعرض المسارات التي تم قطعها؟
يتم تحديد الخطوط المتعددة المشفّرة بدقة لخمسة أرقام عشرية فقط، ما يؤدي إلى خطأ يبلغ مترين تقريبًا. وبالتالي، فإن الخطوط المتعددة المشفَّرة غير مناسبة إذا كنت تريد أن تسير المسارات التي تم طقطقتها طريقًا على مستويات تكبير/تصغير عالية.

المشاكل الشائعة

لم يتم التقاط بعض النقاط، أو لدي فجوات في المسارات التي تم قطعها. كيف يمكنني تصحيح ذلك؟
  • إذا كنت تجري أخذ عينات من نقاطك على فترات زمنية، فتأكد من أخذ عيناتك من نقاطك على فترات زمنية أقصر (كل 1-10 ثوانٍ). في حالة استخدام فاصل زمني أطول (على سبيل المثال 60 ثانية)، قد لا تتمكن خوارزمية محاذاة إلى الطريق من تحديد الطرق التي تم قطعها بدقة كافية.
  • إذا كنت تنقر يدويًا على خريطة لإنشاء نقاط، فمن السهل جدًا إنشاء مسارات تحتوي على القليل من النقاط أو نقاط متناثرة لا تتعامل معها خوارزمية الانطباق. وتعمل خوارزمية الانطباق بشكل أفضل للنقاط القريبة من بعضها. يمكنك تجربة العرض التوضيحي لـ "محاذاة إلى الطرق" أو استخدام فاحص الطرق لاختبار مساراتك.
لماذا تظهر مساراتي المائلة بشكل متعرج أو بعيدة قليلاً عن الطريق عند التكبير؟
  • هل تقتطع دقة أزواج خطوط الطول وخطوط العرض قبل عرضها؟ يؤدي تخزين أزواج خطوط الطول/العرض الملتقطة بدقة تصل إلى أقل من 7 نقاط عشرية إلى حدوث أخطاء في الدقة عند عرض المسار الملتقط على الخريطة.
  • هل تستخدم الخطوط المتعددة المشفّرة؟ تؤدي الخطوط المتعددة المشفرة إلى اقتطاع أزواج خطوط الطول/العرض إلى 5 أماكن عشرية، مما يؤدي إلى حدوث خطأ عدة أمتار، مما يؤدي إلى ظهور خطوط مسننة أو بعيدة قليلاً عن الطريق عند مستويات التكبير أو التصغير المرتفعة.

إذا لم يكن أي مما سبق هو الحال، فربما تم تحديث مربعات الخرائط مؤخرًا، مما يجعلها غير متزامنة مع فهرس الطريق المستخدم لالتقاط الصور. إذا تأثر عدد قليل فقط من طلبات البحث بهذا، فمن المحتمل أن يكون هذا هو السبب. ونظرًا لأنه يتم تحديث "خرائط Google" بانتظام، قد يحدث ذلك من حين لآخر، وقد يحدث هذا بشكل أكثر تكرارًا إذا كنت تطّلع بانتظام على المسارات القديمة على الخريطة (مثل المسارات التي تم التقاطها قبل عدة أسابيع). للحصول على أفضل عرض مرئي، يجب إعادة محاذاة المسارات القديمة قبل عرضها على الخريطة مباشرة للحد من التناقضات بين مربعات الخريطة وفهرس الطرق المستخدم في الالتقاط.

ما الذي يمكن أن يتسبب في عرض حد السرعة للطريق X بشكل غير صحيح؟
تأتي حدود السرعة من عدة مصادر تختلف في الدقة والتغطية. إذا وجدت نمطًا ما، على سبيل المثال حدود السرعة لنوع معين من الطرق أو في منطقة معينة بشكل خاطئ، فالرجاء اتخاذ الخطوات التالية لإخبارنا بذلك:
  1. افتح خرائط Google على كمبيوتر سطح المكتب أو تطبيق خرائط Google لأجهزة Android.
  2. افتح القائمة الجانبية اليمنى.
  3. اختيار إرسال التعليقات ملاحظة: قد تتم مطالبتك بتسجيل الدخول.
  4. حدد تعديل الخريطة.
  5. حدد جزء الطريق الذي تريد تعديله.
  6. اختر التالي.
  7. في الحقل "غير ذلك"، وضح أن حد السرعة خاطئ لهذه الطريق.
  8. انقر على إرسال.
يمكنك أيضًا الإبلاغ عن مشاكل أخرى هنا (على سبيل المثال، إذا كانت الطريق تحمل اسمًا غير صحيح، أو مرسومة بشكل غير صحيح، أو مغلقة، أو خاصة).
لماذا يقطع مساري المقطوع الزوايا بدلاً من متابعة الطريق؟
لتصحيح هذه المشكلة، تحقَّق مما يلي:
  • تأكَّد من ضبط المَعلمة interpolate على true.
  • تحقق من أخذ عينات من نقاط البيانات الأصلية على فترات قريبة بما يكفي (كل 1-10 ثوانٍ).
لماذا أحصل على العديد من أجزاء الطريق التي تم إرجاعها في المسار الذي تم قطعه لطريق ما بدون تغييرات في حدود السرعة؟
عندما يتم تعيين المعلمة interpolate على true، يعرض طلب البحث السريع على الطريق خطًا متعدد الأضلاع يتبع الطريق حول الزوايا والمنحنيات والتقاطعات الدائرية. في حالة انحناءات الطريق، يتم عرض أجزاء متعددة من الطريق حتى إذا لم يتغير حد السرعة، لإنشاء خط متعدد الذي يتبع هندسة الطريق عن كثب.