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

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

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

למה כדאי להשתמש ב-Directions API (גרסה קודמת)

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

מה אפשר לעשות עם Directions API (גרסה קודמת)?

בעזרת Directions API (גרסה קודמת), אפשר לחשב מסלולים בין מיקומים, כולל הפרטים הבאים:

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

איך Directions API (Legacy) פועל

‫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 Client, ‏ Python Client, ‏ Go Client ו-Node.js Client for Google Maps Services הן ספריות לקוח עם תמיכה מהקהילה, שזמינות בקוד פתוח במסגרת רישיון Apache 2.0. אפשר להוריד אותם מ-GitHub, שבו אפשר גם למצוא הוראות התקנה וקוד לדוגמה.

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