סקירה כללית על Directions API (קודם)

מפתחים באזור הכלכלי האירופי (EEA)

‫Directions API (גרסה קודמת) הוא שירות שמקבל בקשת HTTP ומחזיר הוראות הגעה בין מיקומים בפורמט JSON או XML.

למה כדאי להשתמש ב-Directions API

באמצעות Directions API, אפשר לקבל מסלולים למספר אמצעי תחבורה, כמו תחבורה ציבורית, נהיגה, הליכה או רכיבה על אופניים.

מה אפשר לעשות באמצעות Directions API?

באמצעות Directions API אפשר לחשב מסלולים בין מיקומים, כולל הפרטים הבאים:

  • מסלולים לכמה אמצעי תחבורה, כולל תחבורה ציבורית, נהיגה, הליכה או רכיבה על אופניים.
  • מסלולים מרובי חלקים באמצעות סדרה של נקודות ציון.
  • אפשר לציין מקורות, יעדים ונקודות עצירה בכמה דרכים, כולל כמחרוזות טקסט (לדוגמה, 'שיקגו, אילינוי' או 'דרווין, הטריטוריה הצפונית, אוסטרליה'), מזהי מקומות או קואורדינטות של קו רוחב וקו אורך.

איך Directions API פועל

‫Directions API מחזיר את המסלולים הכי יעילים כשמחשבים מסלולים. כדי לקבוע את המסלול היעיל ביותר, המוצר מביא בחשבון את רכיבי הנסיעה הבאים:

  • זמן הגעה (ראשי)
  • מרחק
  • מספר התורות

בדוגמת הבקשה הבאה מוחזרות הוראות נסיעה מטורונטו, אונטריו למונטריאול, קוויבק בפורמט JSON:

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

משאבים

בטבלה הבאה מפורטים המשאבים שזמינים דרך Directions API והנתונים שמוחזרים.

מקורות נתונים הנתונים שהוחזרו פורמט ההחזרה
מסלול

מציינים את נקודות המוצא והיעד באמצעות מזהי מקומות, כתובות או קואורדינטות של קווי רוחב ואורך. פרטים נוספים זמינים במאמר בנושא פרמטרים נדרשים.

הוראות מפורטות, מחולקות למסלולים, לקטעים ולשלבים. פרטים נוספים מופיעים במאמר בנושא תגובות של בקשות לחיפוש מסלולים.
  • JSON
  • XML

איך משתמשים ב-Directions API

1 איך מגדירים את התכונה מתחילים עם הגדרת הפרויקט ב-Google Cloud ופועלים לפי הוראות ההגדרה שבהמשך.
2 לניסיון ההדגמה אחרי שיוצרים מפתח API ופרויקט בענן, אפשר לנסות את ההדגמה של שירות הניווט ללא תשלום. הדגמה של Directions API
3 יצירת בקשה אפשר לעיין בדוגמאות לבקשות וללמוד על האפשרויות הזמינות שאפשר לציין, כמו אמצעי תחבורה, נקודות ציון והגבלות על המסלול. דוגמאות להוראות הגעה
4 הסבר על תשובות כדאי לעיין בתשובות של נתוני הנחיות כדי להתכונן לשימוש בנתוני הנחיות באפליקציה. פרטים נוספים זמינים במאמר בנושא תשובות של נתוני הנחיות.
5 שילוב נתוני כיוון באפליקציה שלכם אפשר להשתמש בנתונים האלה כדי לחשב את מרחק הנסיעה ואת זמן הנסיעה.

ספריות לקוח זמינות

אפשר לקרוא ל-API הזה בשפה הרצויה באמצעות אחת מספריות הלקוח הבאות:

הלקוחות של Java, ‏ Python, ‏ Go ו-Node.js עבור Google Maps Services הם ספריות לקוח עם תמיכה מהקהילה, שזמינות בקוד פתוח במסגרת רישיון Apache 2.0. אפשר להוריד אותם מ-GitHub, שם אפשר גם למצוא הוראות התקנה וקוד לדוגמה.

המאמרים הבאים