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

الأخطاء

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

تراجع أسي

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

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

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

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

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