סקירה כללית על Directions API (Legacy) (Legacy)

מפתחים באזור הכלכלי האירופי (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 (Legacy) יחד עם הנתונים שהוא מחזיר.

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

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

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

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

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

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

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

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

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