סקירה כללית על 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, שם אפשר למצוא גם הוראות התקנה וקוד לדוגמה.

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