واجهة برمجة التطبيقات للاتجاهات هي خدمة ويب تستخدم طلب HTTP لعرض الاتجاهات بتنسيق JSON أو XML بين المواقع. تتوفر الاتجاهات بعدة أشكال:
- كواجهة برمجة تطبيقات مستقلة
- كجزء من واجهة برمجة تطبيقات JavaScript للخرائط من جهة العميل
- للاستخدام من جانب الخادم كجزء من مكتبات العملاء لخدمات ويب خرائط Google
ما أهمية الاتجاهات بالنسبة إليك؟
تتيح لك الاتجاهات حساب الاتجاهات بين المواقع.
لماذا تستخدم الاتجاهات؟
باستخدام الاتجاهات، يمكنك استرداد أكثر من مجرد اتجاهات قيادة بسيطة. يمكنك الحصول على الاتجاهات لوسائل نقل متعددة، مثل النقل العام، أو القيادة، أو المشي، أو ركوب الدراجات.
لاستخدام وظائف الاتجاهات والحصول على تسلسل الطلبات والتسلسل التسلسلي للاستجابات وعمليات إعادة المحاولة التلقائية وبعض عمليات التحقق من صحة الطلبات للعملاء، جرِّب إحدى مكتبات العملاء.
إذا كنت تريد عمليات حسابية للاتجاهات تستجيب في الوقت الفعلي لإدخال المستخدم (على سبيل المثال، داخل عنصر واجهة مستخدم)، فاستخدم إذًا واجهة برمجة تطبيقات الاتجاهات. إذا كنت تستخدم واجهة برمجة تطبيقات جافا سكريبت للخرائط فعلاً، فاستخدم خدمة الاتجاهات للحصول على وظائف واجهة برمجة التطبيقات للاتجاهات.
كيفية استخدام الاتجاهات
يمكنك الدخول إلى واجهة برمجة تطبيقات الاتجاهات من خلال واجهة HTTP، مع الطلبات التي تم إنشاؤها كسلسلة عناوين URL. تحتوي السلسلة على أصل ووجهة. يجب أيضًا تقديم مفتاح واجهة برمجة التطبيقات مع كل طلب من طلبات "الاتجاهات".
https://maps.googleapis.com/maps/api/directions/json?origin=Disneyland&destination=Universal+Studios+Hollywood&key=YOUR_API_KEY
اتبع هذا الإجراء لاستخدام واجهة برمجة التطبيقات للاتجاهات.
- إذا كنت تريد استخدام إحدى مكتبات العملاء بدلاً من واجهة برمجة تطبيقات الاتجاهات المستقلة أو خدمة الويب من جانب العميل، فنزّلها وثبتها. تعرَّف على مكتبات العملاء.
- اختر مشروعًا أو أنشئه، ومكّن الفوترة، ومكّن واجهة برمجة تطبيقات الاتجاهات. يُرجى الاطِّلاع على الإعداد في Cloud Console.
- يمكنك إنشاء مفتاح واجهة برمجة تطبيقات وتقييده وإضافته إلى الرمز. راجع استخدام مفتاح واجهة برمجة تطبيقات.
- اعرض طلب الاتجاهات والرد عليها وجرّب نموذجًا للطلب.
المحتوى المقترَح
- مكتبات العملاء - استخدم إحدى مكتبات العملاء التي تتضمن وظائف واجهات برمجة تطبيقات متعددة بما في ذلك الاتجاهات.
- أفضل ممارسات خدمة الويب - تعلم العديد من أفضل الممارسات لاستخدام الاتجاهات والتعامل معها.
- ملاحظات الإصدار - راجع ملاحظات الإصدار للاتجاهات.
- معلومات الحصة والفوترة - يمكنك العثور على وحدات الفوترة والتكاليف للاتجاهات.
- السياسات والقيود - اطّلع على القيود المفروضة على استخدام الاتجاهات.