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

الأخطاء

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

يتضمّن الردّ كائنًا مع عنصر error واحد بما يلي: المفاتيح:

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

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

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

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

تراجع أسي

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

الأسئلة الشائعة حول تحديد المشاكل وحلّها

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

ما هو معدّل تكرار أخذ عينات من الموقع الجغرافي لمركبتي؟

يُنصح باستخدام كل ثانية أو 10 ثوانٍ للحصول على نتائج عالية الجودة عند الالتقاط على الطريق.

هل هناك حدّ أقصى لعدد النقاط التي يمكنني إرسالها لكلّ طلب بحث؟

نعم، يمكن أن يتضمّن طلب البحث 100 نقطة كحدّ أقصى.

ما مستوى الدقة الذي يجب أن أستخدمه لتخزين خط العرض/خط الطول الذي تم قطعه أزواج؟

لضمان اتّباع المسارات المقطوعة للطرق بجميع مستويات التكبير أو التصغير، حتى الحد الأقصى لمستوى التكبير/التصغير، يجب عليك تخزين أزواج خطوط الطول/العرض التي تم التقاطها على 7 المنازل العشرية للدقة.

هل يمكنني استخدام الخطوط المتعددة المشفرة لعرض المسارات المقطوعة؟

لا يتم تحديد الخطوط المتعددة المشفرة إلا بدقة من 5 منازل عشرية، مما نتج عنه خطأ يبلغ مترين تقريبًا. وبالتالي، تكون الخطوط المتعددة المُشفَّرة غير مناسب إذا كنت تريد أن تتبع المسارات المقطوعة الطريق بتكبير/تصغير عالي المستويات.

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

لا يتم قطع بعض النقاط، أو توجد فجوات في المسارات المقطوعة. كيف بإمكان هل هذا صحيح؟

• إذا كنت تستخدم أخذ عينات من نقاطك على فترات زمنية، تأكَّد من أنّ نقاطك أخذ العيّنات على فترات زمنية أقصر (كل ثانية إلى 10 ثوانٍ). في حال استخدام فاصل زمني أطول (60 ثانية على سبيل المثال)، قد لا تتمكن خوارزمية المحاذاة إلى الطريق تحديد الطرق التي تم قطعها بدقة كافية.
• إذا كنت تنقر يدويًا على خريطة لإنشاء نقاط، فمن السهل جدًا إنشاء مسارات ذات نقاط قليلة أو نقاط متفرقة تعرضها خوارزمية المحاذاة لا يعمل بشكل جيد. وتعمل خوارزمية الالتقاط بشكل أفضل مع النقاط بالقرب من بعضها. جرب المحاذاة إلى عرض الطرق أو استخدام الطرق الفاقد لاختبار مساراتك.

لماذا تكون مساراتي المقطوعة مسنّنة أو بعيدًا قليلاً عن الطريق عندما التكبير؟

• هل يتم اقتطاع دقة أزواج خطوط الطول/العرض التي تم التقاطها قبل عرضها؟ تخزين أزواج خطوط الطول/العرض التي تم التقاطها في الدقة الأقل من 7 علامات عشرية تسبب أخطاء في الدقة عند يتم عرض المسار المقطوعة على الخريطة.
• هل تستخدم خطوطًا متعددة مرمّزة؟ اقتطاع الخطوط المتعددة المشفَّرة أزواج خطوط الطول/العرض إلى 5 خانات عشرية، الأمر الذي ينتج عنه خطأ عدة أمتار، مما ينتج عنه خطوط مسنّنة أو بعيدة قليلاً عن الطريق بمستويات تكبير/تصغير عالية.

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

ما الذي قد يتسبب في عرض حد السرعة على الطريق س بشكل غير صحيح؟

تأتي حدود السرعة من عدة مصادر تختلف دقتها وتغطيتها. في حال العثور على نمط، مثل حدود السرعة لنوع معيّن من الطريق أو في منطقة معينة تتسم بخطأ دائمًا، يرجى اتخاذ الخطوات التالية لإعلامنا بذلك:

1. افتح خرائط Google على كمبيوتر سطح المكتب أو تطبيق خرائط Google Android
2. افتح القائمة الجانبية اليمنى.
3. انقر على إرسال الملاحظات. ملاحظة: قد يُطلب منك تسجيل الدخول.
4. اختَر تعديل الخريطة.
5. اختَر جزء الطريق الذي تريد تعديله.
6. اختَر التالي.
7. في قسم "الحالات الأخرى" الإشارة إلى أن حد السرعة خاطئ لهذا الطريق.
8. اختَر إرسال.

يمكنك أيضًا الإبلاغ عن مشكلات أخرى هنا (على سبيل المثال إذا كان الطريق يحتوي على اسم غير صحيح أو رسم غير صحيح أو مغلق أو خاص).

لماذا يقطع مساري المقطوعة زوايا بدلاً من اتباع الطريق؟

لحلّ هذه المشكلة، تحقَّق مما يلي:

• تأكَّد من ضبط مَعلمة interpolate على true.
• التحقق من أخذ عينات من نقاط البيانات الأصلية في فواصل زمنية كافية (كل ثانية إلى 10 ثوانٍ).

لماذا يظهر لي الكثير من أجزاء الطريق في المسار المقطوعة الطريق بدون تغييرات في حدود السرعة؟

عند ضبط مَعلمة interpolate على true، فإن استعلام المحاذاة إلى الطريق يعرض خطًا متعددًا يتبع الطريق حول الزوايا، والمنحنيات والتقاطعات الدائرية. إذا كان الطريق منحنيات، فإن الأجزاء المتعددة من الطريق حتى إذا لم يتغير حد السرعة، لإنشاء خط متعدد تتبع هندسة الطريق بدقة.