המוצר הזה נמצא בסטטוס מדור קודם. החל מאוקטובר 2026, אי אפשר יותר להפעיל את Directions API (Legacy) בפרויקטים חדשים ב-Google Cloud. הפרויקטים הקיימים ממשיכים להיות נתמכים באופן מלא. כדי ליהנות מתכונות חדשות וביצועים משופרים, כדאי לעבור ל-Routes API.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

תשובות לקבלת מסלול

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

המוצר הזה נמצא בסטטוס קודם. החל מאוקטובר 2026, לא תהיה יותר אפשרות להפעיל את Directions API (הגרסה הקודמת) בפרויקטים חדשים ב-Google Cloud. פרויקטים קיימים ימשיכו לקבל תמיכה מלאה. כדי ליהנות מתכונות חדשות ומביצועים משופרים, עברו ל-Routes API.

תשובות לדוגמה

התשובות של Directions API מוחזרות בפורמט שמצוין בדגל output בנתיב הבקשה של כתובת ה-URL.

בהמשך מוצגת בקשת HTTP לדוגמה, שמחשבת את המסלול משיקגו, אילינוי ללוס אנג'לס, קליפורניה דרך שתי נקודות דרך בג'ופלין, מיזורי ובאוקלהומה סיטי, אוקלהומה.

כתובת URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Los%20Angeles%2C%20CA
  &origin=Chicago%2C%20IL
  &waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Chicago%2C%20IL&destination=Los%20Angeles%2C%20CA&waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK&key=YOUR_API_KEY'

בדוגמה שלמעלה, הפלט המבוקש הוא בפורמט JSON. אפשר גם לבקש פלט XML. כדי לראות את תגובות ה-JSON וה-XML לדוגמה, לחצו על הכרטיסיות שבהמשך.

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ7cv00DwsDogRAMDACa2m4K8",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ69Pk6jdlyIcRDqM1KDY3Fpg",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgdL4flSKrYcRnTpP0XQSojM",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJE9on3F3HwoAR9AhGJW_fL-I",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 41.8781139, "lng": -87.6297872 },
            "southwest": { "lat": 34.0523525, "lng": -118.2435717 },
          },
        "copyrights": "Map data ©2022 Google, INEGI",
        "legs":
          [
            {
              "distance": { "text": "579 mi", "value": 932311 },
              "duration": { "text": "8 hours 48 mins", "value": 31653 },
              "end_address": "Joplin, MO, USA",
              "end_location": { "lat": 37.0842449, "lng": -94.513284 },
              "start_address": "Chicago, IL, USA",
              "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
              "steps":
                [
                  {
                    "distance": { "text": "443 ft", "value": 135 },
                    "duration": { "text": "1 min", "value": 24 },
                    "end_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "html_instructions": "Head <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b>",
                    "polyline": { "points": "eir~FdezuOdCEjBC" },
                    "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
                    "travel_mode": "DRIVING",
                  },
                  {
                    "distance": { "text": "269 ft", "value": 82 },
                    "duration": { "text": "1 min", "value": 20 },
                    "end_location": { "lat": 41.8768866, "lng": -87.63073 },
                    "html_instructions": "Turn <b>right</b> at the 1st cross street onto <b>W Van Buren St</b>",
                    "maneuver": "turn-right",
                    "polyline": { "points": "sar~FzdzuO@fC?|@" },
                    "start_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
            // Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity
          ],
        "overview_polyline":
          {
            "points": "eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)",
          },
        "summary": "I-55 S and I-44",
        "warnings": [],
        "waypoint_order": [0, 1],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>I-55 S and I-44</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8781139</lat>
     <lng>-87.6297872</lng>
    </start_location>
    <end_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </end_location>
    <polyline>
     <points>eir~FdezuOdCEjBC</points>
    </polyline>
    <duration>
     <value>24</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Head &lt;b&gt;south&lt;/b&gt; on &lt;b&gt;S Federal St&lt;/b&gt; toward &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>135</value>
     <text>443 ft</text>
    </distance>
   </step>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </start_location>
    <end_location>
     <lat>41.8768866</lat>
     <lng>-87.6307300</lng>
    </end_location>
    <polyline>
     <points>sar~FzdzuO@fC?|@</points>
    </polyline>
    <duration>
     <value>20</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Turn &lt;b&gt;right&lt;/b&gt; at the 1st cross street onto &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>82</value>
     <text>269 ft</text>
    </distance>
    <maneuver>turn-right</maneuver>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>31653</value>
    <text>8 hours 48 mins</text>
   </duration>
   <distance>
    <value>932311</value>
    <text>579 mi</text>
   </distance>
   <start_location>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </start_location>
   <end_location>
    <lat>37.0842449</lat>
    <lng>-94.5132840</lng>
   </end_location>
   <start_address>Chicago, IL, USA</start_address>
   <end_address>Joplin, MO, USA</end_address>
  </leg>
  <!-- Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity -->
  <copyrights>Map data ©2022 Google, INEGI</copyrights>
  <overview_polyline>
   <points>eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)</points>
  </overview_polyline>
  <waypoint_index>0</waypoint_index>
  <waypoint_index>1</waypoint_index>
  <bounds>
   <southwest>
    <lat>34.0523525</lat>
    <lng>-118.2435717</lng>
   </southwest>
   <northeast>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ7cv00DwsDogRAMDACa2m4K8</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ69Pk6jdlyIcRDqM1KDY3Fpg</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgdL4flSKrYcRnTpP0XQSojM</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJE9on3F3HwoAR9AhGJW_fL-I</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

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

תוצאות XML מוקפות ברכיב בסיס <DirectionsResponse>.
ב-JSON, רשומות עם כמה רכיבים מסומנות באמצעות מערכים ברבים (כמו steps ו-legs), וב-XML הן מסומנות באמצעות כמה רכיבים ביחיד (כמו <step> ו-<leg>).
ב-JSON, סדר נקודות הדרך מצוין בשדה waypoint_order, וב-XML הוא מצוין באמצעות רכיבי <waypoint_index> נפרדים.
רכיבים ריקים מצוינים באמצעות מערכים ריקים ב-JSON, אבל ב-XML הם מצוינים על ידי היעדר רכיב כזה. לדוגמה, תגובה שלא יוצרת תוצאות תחזיר מערך routes ריק ב-JSON, אבל לא רכיבי <route> ב-XML.

DirectionsResponse

שדה	חובה	סוג	תיאור
`routes`	חובה	‫Array<DirectionsRoute>	מכיל מערך של מסלולים מהמוצא אל היעד. מסלולים מורכבים מחלקים ומשלבים מקוננים. מידע נוסף זמין במאמר DirectionsRoute.
`status`	חובה	DirectionsStatus	מכיל את סטטוס הבקשה, ויכול להכיל מידע על תוצאות ניפוי הבאגים כדי לעזור לכם להבין למה הבקשה נכשלה. מידע נוסף זמין במאמר DirectionsStatus.
`available_travel_modes`	אופציונלי	Array<TravelMode>	מכיל מערך של אמצעי הגעה זמינים. השדה הזה מוחזר כשבקשה מציינת אמצעי תחבורה ולא מתקבלות תוצאות. המערך מכיל את אמצעי התחבורה הזמינים במדינות של קבוצת נקודות הדרך הנתונה. השדה הזה לא מוחזר אם אחת או יותר מנקודות הדרך הן "נקודות דרך מסוג via". מידע נוסף זמין במאמר TravelMode.
`error_message`	אופציונלי	מחרוזת	כשהשירות מחזיר קוד סטטוס שונה מ-`OK`, יכול להיות שיהיה שדה `error_message` נוסף באובייקט התגובה. השדה הזה מכיל מידע מפורט יותר על הסיבות לקוד הסטטוס שניתן. השדה הזה לא תמיד מוחזר, והתוכן שלו עשוי להשתנות.
`geocoded_waypoints`	אופציונלי	מערך<DirectionsGeocodedWaypoint>	מכיל מערך עם פרטים על המרת הכתובות לקואורדינטות של נקודת המוצא, היעד ונקודות הציון. הרכיבים במערך geocoded_waypoints תואמים, לפי המיקום שלהם שמתחיל באפס, לנקודת המוצא, לנקודות הדרך בסדר שבו הן צוינו וליעד. הפרטים האלה לא יופיעו בנקודות ציון שצוינו כערכי קו רוחב/קו אורך בטקסט אם השירות לא מחזיר תוצאות. הסיבה לכך היא שנקודות הדרך האלה עוברות המרה הפוכה של קואורדינטות לכתובות (reverse geocoding) כדי לקבל את הכתובת שמייצגת אותן רק אחרי שנמצא מסלול. אובייקט JSON ריק יתפוס את המקומות המתאימים במערך geocoded_waypoints. מידע נוסף זמין במאמר DirectionsGeocodedWaypoint.

DirectionsRoute

המסלולים מורכבים מ-legs ומ-steps בתצוגת עץ.

שדה	חובה	סוג	תיאור
`bounds`	חובה	גבולות	מכיל את התיבה התוחמת של אזור התצוגה של `overview_polyline`. מידע נוסף זמין בקטע גבולות.
`copyrights`	חובה	מחרוזת	מכיל את ההודעות על זכויות היוצרים שיוצגו במסלול הזה. אתם צריכים לטפל במידע הזה ולהציג אותו בעצמכם. התוכן הזה מיועד לקריאה כמו שהוא. אין לנתח באופן פרוגרמטי את התוכן הזה, שמיועד לתצוגה בלבד.
`legs`	חובה	מערך<DirectionsLeg>	מערך שמכיל מידע על מקטע במסלול, בין שני מיקומים במסלול הנתון. כל קטע יופיע בנפרד לכל נקודת ציון או יעד שצוינו. (מסלול בלי נקודות דרך יכיל בדיוק מקטע אחד במערך legs.) כל מקטע מורכב מסדרה של שלבים. מידע נוסף זמין במאמר DirectionsLeg.
`overview_polyline`	חובה	DirectionsPolyline	מכיל אובייקט עם ייצוג של קו פוליגוני מקודד של המסלול. הקו הפוליגוני הזה הוא מסלול משוער (מוחלק) של המסלול שנוצר. מידע נוסף זמין במאמר DirectionsPolyline.
`summary`	חובה	מחרוזת	מכיל תיאור טקסטואלי קצר של המסלול, שמתאים למתן שם למסלול ולהבחנה בינו לבין חלופות.
`warnings`	חובה	מערך<string>	מכיל מערך של אזהרות שיוצגו כשמציגים את המסלול הזה. אתם צריכים לטפל באזהרות האלה ולהציג אותן בעצמכם.
`waypoint_order`	חובה	מערך<integer>	מערך שמציין את הסדר של נקודות הדרך במסלול המחושב. יכול להיות שהסדר של נקודות הדרך האלה ישתנה אם הבקשה הועברה עם optimize:true בפרמטר waypoints.
`fare`	אופציונלי	תעריף	אם השדה הזה מופיע, הוא מכיל את מחיר הנסיעה הכולל (כלומר, העלות הכוללת של הכרטיסים) במסלול הזה. המאפיין הזה מוחזר רק לבקשות של תחבורה ציבורית ורק למסלולים שבהם מידע על תעריפים זמין לכל מקטעי התחבורה הציבורית. מידע נוסף זמין בקטע תעריף.

גבולות

מלבן בקואורדינטות גיאוגרפיות מנקודות בפינות הדרום-מערבית והצפון-מזרחית.

שדה	חובה	סוג	תיאור
`northeast`	חובה	LatLngLiteral	מידע נוסף זמין במאמר LatLngLiteral.
`southwest`	חובה	LatLngLiteral	מידע נוסף זמין במאמר LatLngLiteral.

LatLngLiteral

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

שדה	חובה	סוג	תיאור
`lat`	חובה	number	קו רוחב במעלות עשרוניות
`lng`	חובה	number	קו אורך במעלות עשרוניות

DirectionsLeg

שדה	חובה	סוג	תיאור
`end_address`	חובה	מחרוזת	מכיל את הכתובת הקריאה לאנשים (בדרך כלל כתובת רחוב) מהמרת קואורדינטות לכתובות (reverse geocoding) של `end_location` של הקטע הזה. התוכן הזה מיועד לקריאה כמו שהוא. אל תנתחו באופן פרוגרמטי את הכתובת המעוצבת.
`end_location`	חובה	LatLngLiteral	הקואורדינטות של קו הרוחב/האורך של היעד הנתון של המקטע הזה. ‫Directions API מחשב מסלולים בין מיקומים באמצעות אפשרות התחבורה הקרובה ביותר (בדרך כלל כביש) בנקודות ההתחלה והסיום, לכן `end_location` עשוי להיות שונה מהיעד שצוין בקטע הזה אם, לדוגמה, אין כביש ליד היעד. מידע נוסף זמין במאמר LatLngLiteral.
`start_address`	חובה	מחרוזת	מכיל את הכתובת הקריאה לאנשים (בדרך כלל כתובת רחוב) שנובעת מהמרת קואורדינטות לכתובות (reverse geocoding) של `start_location` של הקטע הזה. התוכן הזה מיועד לקריאה כמו שהוא. אל תנתחו באופן פרוגרמטי את הכתובת המעוצבת.
`start_location`	חובה	LatLngLiteral	הקואורדינטות של קו הרוחב/קו האורך של נקודת המוצא של המקטע הזה. ‫Directions API מחשב מסלולים בין מיקומים באמצעות אפשרות התחבורה הקרובה ביותר (בדרך כלל כביש) בנקודות ההתחלה והסיום, לכן הערך של `start_location` עשוי להיות שונה מנקודת המוצא שצוינה למקטע הזה אם, לדוגמה, אין כביש ליד נקודת המוצא. מידע נוסף זמין במאמר LatLngLiteral.
`steps`	חובה	Array<DirectionsStep>	מערך של שלבים שמציינים מידע על כל שלב נפרד בקטע של המסלול. מידע נוסף זמין במאמר DirectionsStep.
`traffic_speed_entry`	אופציונלי	Array<DirectionsTrafficSpeedEntry>	הוצא משימוש: המערך הזה תמיד ריק. מידע על מהירות התנועה לאורך המקטע. מידע נוסף זמין במאמר בנושא DirectionsTrafficSpeedEntry.
`via_waypoint`	חובה	מערך<DirectionsViaWaypoint>	המיקומים של נקודות הדרך לאורך הקטע הזה. מידע נוסף זמין במאמר DirectionsViaWaypoint.
`arrival_time`	אופציונלי	TimeZoneTextValueObject	מכיל את זמן ההגעה המשוער לקטע הזה. המאפיין הזה מוחזר רק במסלולים לתחבורה ציבורית. מידע נוסף זמין במאמר TimeZoneTextValueObject.
`departure_time`	אופציונלי	TimeZoneTextValueObject	מכיל את שעת היציאה המשוערת של המקטע הזה, שצוינה כאובייקט זמן. השדה `departure_time` זמין רק למסלולים לתחבורה ציבורית. מידע נוסף זמין במאמר TimeZoneTextValueObject.
`distance`	אופציונלי	TextValueObject	המרחק הכולל של המקטע הזה. מידע נוסף זמין במאמר TextValueObject.
`duration`	אופציונלי	TextValueObject	משך הזמן הכולל של המקטע הזה. מידע נוסף זמין במאמר TextValueObject.
`duration_in_traffic`	אופציונלי	TextValueObject	מציין את משך הזמן הכולל של המקטע הזה. הערך הזה הוא אומדן של משך הנסיעה בהתאם למצב התנועה הנוכחי וההיסטורי. בפרמטר הבקשה `traffic_model` מפורטות האפשרויות שבהן אפשר להשתמש כדי לבקש שהערך שיוחזר יהיה אופטימי, פסימי או הערכה משוערת. משך הנסיעה בעומס התנועה מוחזר רק אם כל התנאים הבאים מתקיימים: הבקשה לא כוללת נקודות עצירה. אם הבקשה כוללת נקודות ציון, צריך להוסיף להן את הקידומת `via:` כדי להימנע מעצירות ביניים. הבקשה היא ספציפית למסלול נסיעה – הפרמטר mode מוגדר לערך `driving`. הבקשה כוללת את הפרמטר `departure_time`. מצב התנועה זמין במסלול המבוקש. מידע נוסף זמין במאמר TextValueObject.

DirectionsStep

כל רכיב במערך השלבים מגדיר שלב אחד במסלול המחושב. שלב הוא היחידה האטומית ביותר של מסלול, והוא מכיל שלב אחד שמתאר הוראה ספציפית אחת במסלול. לדוגמה: "פנה שמאלה ברחוב W. ‫4th St." השלב לא רק מתאר את ההוראה, אלא גם מכיל מידע על המרחק ומשך הזמן שקשורים לאופן שבו השלב הזה קשור לשלב הבא. לדוגמה, שלב שנקרא "השתלבות ב-I-80 West" עשוי להכיל משך של "37 מיילים" ו-"40 דקות", כלומר השלב הבא נמצא במרחק של 37 מיילים או 40 דקות מהשלב הזה.

כשמשתמשים ב-Directions API כדי לחפש מסלולים לתחבורה ציבורית, מערך השלבים יכלול פרטים נוספים על התחבורה הציבורית בצורת מערך transit_details. אם המסלול כולל כמה אמצעי תחבורה, יוצגו הוראות מפורטות להליכה או לנהיגה במערך של שלבים פנימיים. לדוגמה, שלב הליכה יכלול הוראות ממיקום ההתחלה ועד למיקום הסיום: "הולכים אל Innes Ave & Fitch St". השלב הזה יכלול מסלול הליכה מפורט באותו מסלול במערך השלבים הפנימיים, למשל: "פונים לכיוון צפון-מערב", "פונים שמאלה אל Arelious Walker" ו "פונים שמאלה אל Innes Ave".

שדה	חובה	סוג	תיאור
`duration`	חובה	TextValueObject	מכיל את הזמן הטיפוסי שנדרש לביצוע השלב, עד לשלב הבא. יכול להיות שהשדה הזה לא יהיה מוגדר אם משך הזמן לא ידוע. מידע נוסף זמין במאמר TextValueObject.
`end_location`	חובה	LatLngLiteral	מכיל את המיקום של הנקודה האחרונה בשלב הזה. מידע נוסף זמין במאמר LatLngLiteral.
`html_instructions`	חובה	מחרוזת	מכיל הוראות מעוצבות לשלב הזה, שמוצגות כמחרוזת טקסט ב-HTML. התוכן הזה מיועד לקריאה כמו שהוא. אל תנתחו באופן פרוגרמטי את התוכן הזה, שמיועד לתצוגה בלבד.
`polyline`	חובה	DirectionsPolyline	מכיל אובייקט נקודות יחיד שמכיל ייצוג של קו פוליגוני מקודד של השלב. הקו הפוליגוני הזה הוא נתיב משוער (מוחלק) של השלב. מידע נוסף זמין במאמר DirectionsPolyline.
`start_location`	חובה	LatLngLiteral	מכיל את המיקום של נקודת ההתחלה של השלב הזה. מידע נוסף זמין במאמר LatLngLiteral.
`travel_mode`	חובה	TravelMode	מכיל את סוג אמצעי התחבורה שבו נעשה שימוש. מידע נוסף זמין במאמר TravelMode.
`distance`	אופציונלי	TextValueObject	מכיל את המרחק שהשלב הזה מכסה עד לשלב הבא. יכול להיות שהשדה הזה לא יהיה מוגדר אם המרחק לא ידוע. מידע נוסף זמין במאמר TextValueObject.
`maneuver`	אופציונלי	מחרוזת	מכיל את הפעולה שצריך לבצע בשלב הנוכחי (פנייה שמאלה, השתלבות, נסיעה ישר וכו'). הערכים עשויים להשתנות, וערכים חדשים עשויים להתווסף ללא הודעה מוקדמת. The allowed values include: `turn-slight-left`, `turn-sharp-left`, `turn-left`, `turn-slight-right`, `turn-sharp-right`, `keep-right`, `keep-left`, `uturn-left`, `uturn-right`, `turn-right`, `straight`, `ramp-left`, `ramp-right`, `merge`, `fork-left`, `fork-right`, `ferry`, `ferry-train`, `roundabout-left`, and `roundabout-right`
`steps`	אופציונלי		מכיל הוראות מפורטות להליכה או לנהיגה במסלול לתחבורה ציבורית. שלבי משנה זמינים רק כשמגדירים את travel_mode ל-"transit". מערך השלבים הפנימי הוא מאותו סוג כמו השלבים.
`transit_details`	אופציונלי	DirectionsTransitDetails	פרטים שקשורים לשלב הזה אם אמצעי התחבורה הוא `transit`. מידע נוסף זמין במאמר DirectionsTransitDetails.

TextValueObject

אובייקט שמכיל ערך מספרי וייצוג טקסטואלי בפורמט מסוים.

שדה	חובה	סוג	תיאור
`text`	חובה	מחרוזת	ערך מחרוזת.
`value`	חובה	number	ערך מספרי.

DirectionsPolyline

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

תהליך הקידוד ממיר ערך בינארי לסדרה של קודי תווים לתווי ASCII באמצעות סכמת הקידוד המוכרת Base64: כדי להבטיח שהתווים האלה יוצגו בצורה תקינה, הערכים המקודדים מסוכמים עם 63 (תו ה-ASCII "?") לפני ההמרה שלהם ל-ASCII. האלגוריתם גם בודק אם יש קודי תווים נוספים לנקודה נתונה על ידי בדיקת הביט הכי פחות משמעותי של כל קבוצת בייטים. אם הביט הזה מוגדר ל-1, הנקודה עדיין לא נוצרה במלואה וצריך להוסיף נתונים.

בנוסף, כדי לחסוך מקום, הנקודות כוללות רק את ההיסט מהנקודה הקודמת (חוץ מהנקודה הראשונה, כמובן). כל הנקודות מקודדות ב-Base64 כמספרים שלמים עם סימן, כי קווי הרוחב וקווי האורך הם ערכים עם סימן. פורמט הקידוד בתוך קו פוליגוני צריך לייצג שתי קואורדינטות שמייצגות קו רוחב וקו אורך ברמת דיוק סבירה. בהינתן קו אורך מקסימלי של +/- 180 מעלות בדיוק של 5 ספרות אחרי הנקודה העשרונית (180.00000 עד ‎-180.00000), נדרש ערך של מספר שלם בינארי עם סימן של 32 ביט.

שדה	חובה	סוג	תיאור
`points`	חובה	מחרוזת	ייצוג של הקו הפוליגוני כמחרוזת אחת.

TravelMode

‫DRIVING (ברירת המחדל) מציין חישוב באמצעות רשת הכבישים.
‫BICYCLING מבקש חישוב לרכיבה על אופניים באמצעות שבילי אופניים ורחובות מועדפים (אם יש כאלה).
‫TRANSIT מבקש חישוב באמצעות מסלולי תחבורה ציבורית (אם זמינים).
‫WALKING מבקש חישוב של מסלול הליכה באמצעות שבילים להולכי רגל ומדרכות (אם יש כאלה).

DirectionsTransitDetails

מידע נוסף שלא רלוונטי לאמצעי תחבורה אחרים.

שדה	חובה	סוג	תיאור
`arrival_stop`	אופציונלי	DirectionsTransitStop	תחנת ההגעה של התחבורה הציבורית. מידע נוסף זמין במאמר DirectionsTransitStop.
`arrival_time`	אופציונלי	TimeZoneTextValueObject	מידע נוסף זמין במאמר TimeZoneTextValueObject.
`departure_stop`	אופציונלי	DirectionsTransitStop	תחנת המוצא של התחבורה הציבורית. מידע נוסף זמין במאמר DirectionsTransitStop.
`departure_time`	אופציונלי	TimeZoneTextValueObject	מידע נוסף זמין במאמר TimeZoneTextValueObject.
`headsign`	אופציונלי	מחרוזת	מציין את כיוון הנסיעה בקו הזה, כפי שהוא מסומן על הרכב או בתחנת היציאה. בדרך כלל זו תהיה התחנה הסופית.
`headway`	אופציונלי	מספר שלם	מציין את מספר השניות הצפוי בין יציאות מאותה תחנה בזמן הזה. ‫לדוגמה, אם הערך של `headway` הוא 600, זמן ההמתנה הצפוי אם פספסתם את האוטובוס הוא 10 דקות.
`line`	אופציונלי	DirectionsTransitLine	מכיל מידע על קו התחבורה הציבורית שמשמש בשלב הזה. מידע נוסף זמין במאמר DirectionsTransitLine.
`num_stops`	אופציונלי	מספר שלם	מספר התחנות מתחנת המוצא ועד לתחנת היעד. הנתון הזה כולל את תחנת ההגעה, אבל לא את תחנת היציאה. לדוגמה, אם המסלול כולל יציאה מתחנה א', מעבר בתחנות ב' וג' והגעה לתחנה ד', הפונקציה `num_stops` תחזיר את הערך 3.
`trip_short_name`	אופציונלי	מחרוזת	הטקסט שמופיע בלוחות הזמנים ובשלטים כדי לזהות נסיעה בתחבורה ציבורית עבור הנוסעים. הטקסט צריך לזהות באופן ייחודי נסיעה ביום שירות. לדוגמה, "538" הוא ה-`trip_short_name` של רכבת Amtrak שיוצאת מסן חוזה, קליפורניה בשעה 15:10 בימי חול לסקרמנטו, קליפורניה.

DirectionsTransitStop

שדה	חובה	סוג	תיאור
`location`	חובה	LatLngLiteral	המיקום של התחנה. מידע נוסף זמין במאמר LatLngLiteral.
`name`	חובה	מחרוזת	שם התחנה של התחבורה הציבורית.

TimeZoneTextValueObject

אובייקט שמכיל את ראשית זמן יוניקס (Unix epoch), אזור זמן וייצוג טקסט בפורמט.

שדה	חובה	סוג	תיאור
`text`	חובה	מחרוזת	השעה שצוינה כמחרוזת באזור הזמן.
`time_zone`	חובה	מחרוזת	מכיל את אזור הזמן. הערך הוא השם של אזור הזמן כפי שמוגדר במסד הנתונים של אזור זמן IANA, למשל "America/New_York".
`value`	חובה	number	הזמן שצוין כראשית זמן יוניקס (Unix epoch), או מספר השניות מאז חצות, 1 בינואר 1970 UTC.

DirectionsTransitLine

שדה	חובה	סוג	תיאור
`agencies`	חובה	Array<DirectionsTransitAgency>	חברת התחבורה הציבורית (או החברות) שמפעילה את קו התחבורה הציבורית הזה. מידע נוסף זמין במאמר DirectionsTransitAgency.
`name`	חובה	מחרוזת	השם המלא של קו התחבורה הציבורית, למשל "8 Avenue Local".
`color`	אופציונלי	מחרוזת	הצבע שמופיע בדרך כלל בשילוט של הקו הזה.
`icon`	אופציונלי	מחרוזת	כתובת ה-URL של הסמל שמשויך לקו הזה.
`short_name`	אופציונלי	מחרוזת	השם המקוצר של קו התחבורה הציבורית הזה. בדרך כלל זה יהיה מספר קו, כמו "M7" או "355".
`text_color`	אופציונלי	מחרוזת	הצבע שמופיע בדרך כלל בשילוט של הקו הזה.
`url`	אופציונלי	מחרוזת	כתובת ה-URL של קו התחבורה הציבורית הזה, כפי שסופקה על ידי חברת התחבורה הציבורית.
`vehicle`	אופציונלי	DirectionsTransitVehicle	סוג כלי הרכב שפועל בקו התחבורה הציבורית הזה. מידע נוסף זמין במאמר DirectionsTransitVehicle.

DirectionsTransitAgency

שדה	חובה	סוג	תיאור
`name`	אופציונלי	מחרוזת	השם של חברת התחבורה הציבורית הזו.
`phone`	אופציונלי	מחרוזת	מספר הטלפון של חברת התחבורה הציבורית.
`url`	אופציונלי	מחרוזת	כתובת ה-URL של חברת התחבורה הציבורית.

DirectionsTransitVehicle

שדה	חובה	סוג	תיאור
`name`	חובה	מחרוזת	שם הרכב, באותיות רישיות.
`type`	חובה	מחרוזת	סוג הרכב שבו השתמשתם. ‫`BUS` – אוטובוס. `CABLE_CAR` – כלי רכב שפועל על כבל, בדרך כלל על הקרקע. רכבלים יכולים להיות מסוג GONDOLA_LIFT. ‫`COMMUTER_TRAIN` – רכבת פרברים. ‫`FERRY` – מעבורת. `FUNICULAR` – רכב שנמשך במעלה שיפוע תלול באמצעות כבל. פוניקולר מורכב בדרך כלל משני קרונות, כאשר כל קרון משמש כמשקל נגד לשני. `GONDOLA_LIFT` – רכבל. ‫`HEAVY_RAIL` – רכבת כבדה. `HIGH_SPEED_TRAIN` – רכבת מהירה. ‫`INTERCITY_BUS` – אוטובוס בין-עירוני. ‫`LONG_DISTANCE_TRAIN` – רכבת למרחקים ארוכים. `METRO_RAIL` – רכבת קלה. ‫`MONORAIL` – Monorail. `OTHER` – כל שאר הרכבים יחזירו את הסוג הזה. `RAIL` – רכבת. `SHARE_TAXI` – מונית שירות היא סוג של אוטובוס שיכול להוריד נוסעים ולאסוף אותם בכל מקום לאורך המסלול שלו. `SUBWAY` – רכבת קלה תת-קרקעית. `TRAM` – רכבת קלה עילית. ‫`TROLLEYBUS` – אוטובוס חשמלי. The allowed values include: `BUS`, `CABLE_CAR`, `COMMUTER_TRAIN`, `FERRY`, `FUNICULAR`, `GONDOLA_LIFT`, `HEAVY_RAIL`, `HIGH_SPEED_TRAIN`, `INTERCITY_BUS`, `LONG_DISTANCE_TRAIN`, `METRO_RAIL`, `MONORAIL`, `OTHER`, `RAIL`, `SHARE_TAXI`, `SUBWAY`, `TRAM`, and `TROLLEYBUS`
`icon`	אופציונלי	מחרוזת	מכיל את כתובת ה-URL של סמל שמשויך לסוג כלי רכב זה.
`local_icon`	אופציונלי	מחרוזת	מכיל את כתובת ה-URL של הסמל שמשויך לסוג כלי הרכב הזה, על סמך השילוט המקומי של התחבורה.

DirectionsTrafficSpeedEntry

שדה	חובה	סוג	תיאור
`offset_meters`	חובה	number	ההיסט לאורך המסלול (במטרים) שעד אליו קטגוריית המהירות הזו תקפה.
`speed_category`	חובה	מחרוזת	מצב התנועה/המהירות הנוכחי בחלק הזה של המסלול.

DirectionsViaWaypoint

שדה	חובה	סוג	תיאור
`location`	אופציונלי	LatLngLiteral	המיקום של ציון הדרך. מידע נוסף זמין במאמר LatLngLiteral.
`step_index`	אופציונלי	מספר שלם	האינדקס של השלב שמכיל את ציון הדרך.
`step_interpolation`	אופציונלי	number	המיקום של נקודת הדרך לאורך הקו הפוליגוני של השלב, מבוטא כיחס בין 0 ל-1.

מחיר הכרטיס

המחיר הכולל של המסלול.

{
  "currency" : "USD",
  "value" : 6,
  "text" : "$6.00"
}

שדה	חובה	סוג	תיאור
`currency`	חובה	מחרוזת	קוד מטבע בתקן ISO 4217 שמציין את המטבע שבו הסכום מבוטא.
`text`	חובה	מחרוזת	הסכום הכולל של מחיר הנסיעה, בפורמט של השפה המבוקשת.
`value`	חובה	number	סכום הנסיעה הכולל, במטבע שצוין.

DirectionsStatus

השדה status באובייקט התגובה של Directions מכיל את סטטוס הבקשה, ויכול להכיל מידע על תוצאות ניפוי הבאגים שיעזור לכם להבין למה שירות המסלולים נכשל. השדה status יכול להכיל את הערכים הבאים:

הערך OK מציין שהתשובה מכילה תוצאה תקינה.
‫NOT_FOUND מציין שלא ניתן היה להמיר לקואורדינטות לפחות אחד מהמיקומים שצוינו בנקודת המוצא, בנקודת היעד או בנקודות הדרך של הבקשה.
הערך ZERO_RESULTS מציין שלא נמצא מסלול בין נקודת המוצא ליעד.
הערך MAX_WAYPOINTS_EXCEEDED מציין שצוינו יותר מדי נקודות ציון בבקשה. באפליקציות שמשתמשות ב-Directions API כשירות אינטרנט, או בשירות המסלולים ב-Maps JavaScript API, המספר המקסימלי המותר של נקודות ציון הוא 25, בנוסף לנקודת המוצא וליעד.
‫MAX_ROUTE_LENGTH_EXCEEDED מציין שהמסלול המבוקש ארוך מדי ואי אפשר לעבד אותו. השגיאה הזו מתרחשת כשמוחזרות הוראות מורכבות יותר. כדאי לנסות לצמצם את מספר נקודות הציון, הפניות או ההוראות.
INVALID_REQUEST מציין שהבקשה שסופקה לא הייתה תקינה. הסיבות הנפוצות לסטטוס הזה כוללות פרמטר או ערך פרמטר לא תקינים.
OVER_DAILY_LIMIT מציין אחת מהאפשרויות הבאות:
- מפתח ה-API חסר או לא תקין.
- החיוב לא הופעל בחשבון שלכם.
- חרגתם ממכסת השימוש שהגדרתם לעצמכם.
- אמצעי התשלום שסופק כבר לא תקף (לדוגמה, פג התוקף של כרטיס האשראי).
כדי לפתור את הבעיה, אפשר לעיין בשאלות הנפוצות בנושא מפות Google.
‫OVER_QUERY_LIMIT מציין שהשירות קיבל יותר מדי בקשות מהאפליקציה שלכם בפרק הזמן המותר.
‫REQUEST_DENIED מציין שהשירות דחה את השימוש של האפליקציה בשירות המסלולים.
‫UNKNOWN_ERROR מציין שלא ניתן היה לעבד בקשה לקבלת מסלול בגלל שגיאה בחיבור לשרת. יכול להיות שהבקשה תצליח אם תנסו שוב.

DirectionsGeocodedWaypoint

שדה	חובה	סוג	תיאור
`geocoder_status`	אופציונלי	מחרוזת	מציין את קוד הסטטוס שנוצר כתוצאה מהפעולה של המרת הכתובת לקואורדינטות. השדה הזה יכול להכיל את הערכים הבאים. The allowed values include: `OK`, and `ZERO_RESULTS`
`partial_match`	אופציונלי		מציין שהכלי להמרת כתובות לקואורדינטות לא החזיר התאמה מדויקת לבקשה המקורית, אבל הוא הצליח להתאים חלק מהכתובת המבוקשת. כדאי לבדוק אם יש שגיאות כתיב בבקשה המקורית או אם הכתובת לא מלאה. התאמות חלקיות מתרחשות בדרך כלל בכתובות רחוב שלא קיימות ביישוב שאתם מעבירים בבקשה. יכול להיות שיוחזרו התאמות חלקיות גם כשבקשה תואמת לשני מיקומים או יותר באותו יישוב. לדוגמה, "21 Henr St, Bristol, UK" יחזיר התאמה חלקית גם ל-Henry Street וגם ל-Henrietta Street. שימו לב שאם הבקשה כוללת רכיב כתובת עם שגיאת כתיב, שירות המרת הכתובות לקואורדינטות עשוי להציע כתובת חלופית. הצעות שמופעלות בדרך הזו יסומנו גם כהתאמה חלקית.
`place_id`	אופציונלי	מחרוזת	מזהה ייחודי שאפשר להשתמש בו עם ממשקי Google API אחרים. סקירה כללית על מזהה מקום
`types`	אופציונלי	מערך<string>	מציין את סוג הכתובת של תוצאת המרת הכתובת לקואורדינטות שמשמשת לחישוב המסלול. `administrative_area_level_1` מציין חלוקה מנהלית מדרגה ראשונה מתחת לרמה הארצית. בארצות הברית, הרמות המנהליות האלה הן מדינות. לא בכל הארצות משתמשים ברמות המנהליות האלה. ברוב המקרים, השמות המקוצרים של administrative_area_level_1 יהיו דומים מאוד לחלוקות המשנה של ISO 3166-2 ולרשימות אחרות שמופצות באופן נרחב. עם זאת, אין ערובה לכך, כי התוצאות של המרת הכתובות לקואורדינטות מבוססות על מגוון אותות ונתוני מיקום. הסמל `administrative_area_level_2` מציין חלוקה מנהלית מדרגה שנייה מתחת לרמה הארצית. בארצות הברית, הרמות המנהליות האלה הן מחוזות. לא בכל הארצות משתמשים ברמות המנהליות האלה. הסמל `administrative_area_level_3` מציין חלוקה מנהלית מדרגה שלישית מתחת לרמה הארצית. הסוג הזה מציין חלוקה אזרחית משנית. לא בכל הארצות משתמשים ברמות המנהליות האלה. `administrative_area_level_4` מציין חלוקה מנהלית מדרגה רביעית מתחת לרמה הארצית. הסוג הזה מציין חלוקה אזרחית משנית. לא בכל הארצות משתמשים ברמות המנהליות האלה. `administrative_area_level_5` מציין חלוקה מנהלית מדרגה חמישית מתחת לרמה הארצית. הסוג הזה מציין חלוקה אזרחית משנית. לא בכל הארצות משתמשים ברמות המנהליות האלה. `airport` מציין נמל תעופה. ‫`colloquial_area` מציין שם חלופי נפוץ לישות. ‫`country` מציין את הישות הפוליטית הלאומית, ובדרך כלל זהו סוג הסדר הגבוה ביותר שמוחזר על ידי הכלי להמרת כתובות לקואורדינטות (geocoder). `intersection` מציין צומת ראשי, בדרך כלל של שני כבישים ראשיים. `locality` מציין ישות פוליטית של עיר או עיירה מאוגדת. `natural_feature` מציין מאפיין טבעי בולט. `neighborhood` מציין שכונה עם שם `park` מציין פארק עם שם. `plus_code` מציין הפניה מקודדת למיקום, שנגזרת מקו הרוחב ומקו האורך. אפשר להשתמש ב-Plus Codes במקום כתובות רגילות במקומות שבהם אין כתובות (למשל, במקומות שבהם אין מספרים לבניינים או שמות לרחובות). פרטים נוספים זמינים בכתובת https://plus.codes. `point_of_interest` מציין נקודת עניין עם שם. בדרך כלל, נקודות העניין האלה הן ישויות מקומיות בולטות שלא מתאימות בקלות לקטגוריה אחרת, כמו "בניין האמפייר סטייט" או "מגדל אייפל". `political` מציין ישות פוליטית. בדרך כלל, הסוג הזה מציין פוליגון של מנהל אזרחי כלשהו. `postal_code` מציין מיקוד שמשמש למשלוח דואר בתוך המדינה. `premise` מציין מיקום עם שם, בדרך כלל בניין או אוסף של בניינים עם שם משותף `route` מציין מסלול עם שם (כמו "US 101"). `street_address` מציין כתובת מדויקת. הסמל `sublocality` מציין ישות אזרחית מסדר ראשון מתחת ליישוב. במיקומים מסוימים, יכול להיות שיופיע אחד מהסוגים הנוספים: sublocality_level_1 עד sublocality_level_5. כל רמה של יישוב משנה היא ישות אזרחית. מספרים גדולים יותר מציינים אזור גיאוגרפי קטן יותר. `subpremise` מציין ישות מסדר ראשון מתחת למיקום בעל שם, בדרך כלל בניין יחיד בתוך אוסף של בניינים עם שם משותף ‫`tourist_attraction` מציין אטרקציה תיירותית. ‫`train_station` מציין תחנת רכבת. `transit_station` מציין תחנה של תחבורה ציבורית. רשימה ריקה של סוגים מציינת שאין סוגים ידועים לרכיב הכתובת הספציפי, לדוגמה, Lieu-dit בצרפת.

תשובות לקבלת מסלול קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

תשובות לדוגמה

כתובת URL

curl

JSON

XML

DirectionsResponse

routes

status

available_travel_modes

error_message

geocoded_waypoints

DirectionsRoute

bounds

copyrights

legs

overview_polyline

summary

warnings

waypoint_order

fare

גבולות

northeast

southwest

LatLngLiteral

lat

lng

DirectionsLeg

end_address

end_location

start_address

start_location

steps

traffic_speed_entry

via_waypoint

arrival_time

departure_time

distance

duration

duration_in_traffic

DirectionsStep

duration

end_location

html_instructions

polyline

start_location

travel_mode

distance

maneuver

steps

transit_details

TextValueObject

text

value

DirectionsPolyline

points

TravelMode

DirectionsTransitDetails

arrival_stop

arrival_time

departure_stop

departure_time

headsign

headway

line

num_stops

trip_short_name

DirectionsTransitStop

location

name

TimeZoneTextValueObject

text

time_zone

value

DirectionsTransitLine

agencies

name

color

icon

short_name

תשובות לקבלת מסלול

`routes`

`status`

`available_travel_modes`

`error_message`

`geocoded_waypoints`

`bounds`

`copyrights`

`legs`

`overview_polyline`

`summary`

`warnings`

`waypoint_order`

`fare`

`northeast`

`southwest`

`lat`

`lng`

`end_address`

`end_location`

`start_address`

`start_location`

`steps`

`traffic_speed_entry`

`via_waypoint`

`arrival_time`

`departure_time`

`distance`

`duration`

`duration_in_traffic`

`duration`

`end_location`

`html_instructions`

`polyline`

`start_location`

`travel_mode`

`distance`

`maneuver`

`steps`

`transit_details`

`text`

`value`

`points`

`arrival_stop`

`arrival_time`

`departure_stop`

`departure_time`

`headsign`

`headway`

`line`

`num_stops`

`trip_short_name`

`location`

`name`

`text`

`time_zone`

`value`

`agencies`

`name`

`color`

`icon`

`short_name`

`text_color`

`url`

`vehicle`

`name`

`phone`

`url`

`name`

`type`

`icon`

`local_icon`

`offset_meters`

`speed_category`

`location`

`step_index`

`step_interpolation`

`currency`

`text`

`value`