מדריך מקוצר ל-Distance Matrix API

‫Distance Matrix API (הגרסה הקודמת) הוא שירות אינטרנט שמחזיר את מרחק הנסיעה ואת משך הנסיעה למטריצה של נקודות מוצא ויעדים, על סמך המסלול המומלץ בין כל זוג. אתם יכולים להגדיר את אופן הנסיעה (נהיגה, הליכה, רכיבה על אופניים, תחבורה ציבורית), את מצבי התחבורה הציבורית, את היחידות ואת שעת היציאה למשכי זמן שמבוססים על תנועה. הוא מחזיר JSON או XML.

‫Distance Matrix API: עובדות חשובות

  • המוצר: Distance Matrix API
  • נקרא גם: Distance Matrix API (דור קודם), Distance Matrix (דור קודם)
  • קטגוריה: מסלולים
  • פלטפורמה: שירות אינטרנט (REST)
  • פועל ב: שרת (קוד לקצה העורפי)
  • שלב ההשקה: GA
  • מחזור חיים: מדור קודם
  • הוחלף על ידי: Routes API
  • סקירה כללית: סקירה כללית על Distance Matrix API

‫Distance Matrix API: מתי כדאי להשתמש בו

מתי כדאי להשתמש ב-Distance Matrix API:

  • יש לכם פרויקט קיים שכבר מופעל בו Distance Matrix API (הגרסה הקודמת) ומתבצעות בו קריאות ל-/maps/api/distancematrix.
  • אתם צריכים לקבל משרת את מרחק הנסיעה ואת משך הנסיעה בין כמה נקודות מוצא לכמה יעדים.
  • אתם צריכים משכי זמן בתנועה לנהיגה, באמצעות departure_time ו-traffic_model אופציונלי.

מתי לא כדאי להשתמש ב-Distance Matrix API:

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

‫Distance Matrix API: הגדרה

‫Distance Matrix API: טעויות נפוצות

  • הבעיה: כל בקשה בצד השרת מוגבלת ל-100 רכיבים (נקודות מוצא × יעדים) ול-25 נקודות מוצא או 25 יעדים. בקשות גדולות יותר מחזירות את הערך MAX_ELEMENTS_EXCEEDED או MAX_DIMENSIONS_EXCEEDED. הפתרון: פצלו את המטריצה לבקשות של עד 100 רכיבים ו-25 נקודות מוצא או יעדים. מידע נוסף זמין בכתובת /maps/documentation/distance-matrix/usage-and-billing#usage-limits.
  • הבעיה: אם לא מציינים את departure_time, המסלול ומשך הזמן מבוססים על תנועה ממוצעת שלא תלויה בזמן, ולא מוחזר duration_in_traffic. התוצאות יכולות להשתנות עם הזמן. תיקון: כדי לקבל משכי זמן שמביאים בחשבון את מצב התנועה, צריך להגדיר את departure_time לערך now או לזמן עתידי באמצעות mode=driving. חשוב לשים לב שהחיוב על בקשות תנועה הוא בשיעור גבוה יותר. אפשר לקרוא מידע נוסף בכתובת /maps/documentation/distance-matrix/distance-matrix.
  • הבעיה: הפרמטר units משנה רק את הטקסט בשדות המרחק. ערך המרחק הוא תמיד במטרים. תיקון: צריך לקרוא את distance.value כמטרים, או להשתמש ב-distance.text לתצוגה. אפשר לקרוא מידע נוסף בכתובת /maps/documentation/distance-matrix/distance-matrix.
  • הבעיה: כששולחים קריאה ל-Distance Matrix API (הגרסה הקודמת) מפרויקט שבו הוא לא מופעל, מוחזר הערך REQUEST_DENIED ב-status ו-error_message שמקשר אל LegacyApiNotActivatedMapError. עוזרים אישיים מבוססי-AI יוצרים בדרך כלל קוד API מדור קודם כברירת מחדל. התיקון: עוברים ל-Routes API computeRouteMatrix (עם הכותרת X-Goog-FieldMask). הפעלת ה-API הקודם באמצעות טופס היא רק אמצעי לטווח קצר. מידע נוסף זמין בכתובת /maps/legacy#LegacyApiNotActivatedMapError.