يمكنك تجربة الجيل التالي من ميزات الاتجاهات باستخدام Routes API التي أصبحت متوفّرة الآن في المعاينة.

نظرة عامة على واجهة برمجة تطبيقات الاتجاهات

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

واجهة برمجة التطبيقات للاتجاهات هي خدمة ويب تستخدم طلب HTTP لعرض الاتجاهات بتنسيق JSON أو XML بين المواقع. تتوفر الاتجاهات بعدة أشكال:

ما أهمية الاتجاهات بالنسبة إليك؟

تتيح لك الاتجاهات حساب الاتجاهات بين المواقع.

لماذا تستخدم الاتجاهات؟

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

لاستخدام وظائف الاتجاهات والحصول على تسلسل الطلبات والتسلسل التسلسلي للاستجابات وعمليات إعادة المحاولة التلقائية وبعض عمليات التحقق من صحة الطلبات للعملاء، جرِّب إحدى مكتبات العملاء.

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

كيفية استخدام الاتجاهات

يمكنك الدخول إلى واجهة برمجة تطبيقات الاتجاهات من خلال واجهة HTTP، مع الطلبات التي تم إنشاؤها كسلسلة عناوين URL. تحتوي السلسلة على أصل ووجهة. يجب أيضًا تقديم مفتاح واجهة برمجة التطبيقات مع كل طلب من طلبات "الاتجاهات".

https://maps.googleapis.com/maps/api/directions/json?origin=Disneyland&destination=Universal+Studios+Hollywood&key=YOUR_API_KEY

اتبع هذا الإجراء لاستخدام واجهة برمجة التطبيقات للاتجاهات.

  1. إذا كنت تريد استخدام إحدى مكتبات العملاء بدلاً من واجهة برمجة تطبيقات الاتجاهات المستقلة أو خدمة الويب من جانب العميل، فنزّلها وثبتها. تعرَّف على مكتبات العملاء.
  2. اختر مشروعًا أو أنشئه، ومكّن الفوترة، ومكّن واجهة برمجة تطبيقات الاتجاهات. يُرجى الاطِّلاع على الإعداد في Cloud Console.
  3. يمكنك إنشاء مفتاح واجهة برمجة تطبيقات وتقييده وإضافته إلى الرمز. راجع استخدام مفتاح واجهة برمجة تطبيقات.
  4. اعرض طلب الاتجاهات والرد عليها وجرّب نموذجًا للطلب.

المحتوى المقترَح