המוצר הזה נמצא ב
סטטוס מדור קודם. החל מאוקטובר 2026, אי אפשר יותר להפעיל את Distance Matrix API (גרסה קודמת) בפרויקטים חדשים ב-Google Cloud. הפרויקטים הקיימים ממשיכים להיות נתמכים באופן מלא. כדי ליהנות מתכונות חדשות וביצועים משופרים,
כדאי לעבור ל-Routes API.
Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.
תחילת השימוש ב-Distance Matrix API (גרסה קודמת)
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
דוגמה לבקשה ולתשובה
בדוגמה הזו, הבקשה היא לקבל את נתוני מטריצת המרחקים בין וושינגטון די.סי. לניו יורק, בפורמט JSON:
כתובת URL
https://maps.googleapis.com/maps/api/distancematrix/json
?destinations=New%20York%20City%2C%20NY
&origins=Washington%2C%20DC
&units=imperial
&key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=Washington%2C%20DC&destinations=New%20York%20City%2C%20NY&units=imperial&key=YOUR_API_KEY'
כדאי לנסות! כדי לבדוק את הבקשה, מזינים את כתובת ה-URL בדפדפן האינטרנט. חשוב להחליף את YOUR_API_KEY במפתח ה-API בפועל. התשובה מציגה את המרחק ומשך הזמן בין נקודות המוצא והיעדים שצוינו.
איך יוצרים כתובות URL של בקשות, כולל כל הפרמטרים הזמינים.
דוגמת הקוד הזו היא בפורמטים JSON ו-XML:
JSON
{
"destination_addresses": ["New York, NY, USA"],
"origin_addresses": ["Washington, DC, USA"],
"rows":
[
{
"elements":
[
{
"distance": { "text": "228 mi", "value": 367654 },
"duration": { "text": "3 hours 55 mins", "value": 14078 },
"status": "OK",
},
],
},
],
"status": "OK",
}
XML
OK
Washington, DC, USA
New York, NY, USA
OK
14078
3 hours 55 mins
367654
228 mi
כדי להבין את התגובה, אפשר לעיין במדריך למפתחים.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2026-10-21 (שעון UTC).
[null,null,["עדכון אחרון: 2026-10-21 (שעון UTC)."],[],["The content demonstrates requesting distance data between Washington, DC, and New York City using the Google Maps Distance Matrix API. The request URL and cURL command are provided, requiring the user to replace `YOUR_API_KEY` with their own. The API returns distance (228 mi) and duration (3 hours 55 mins) data in both JSON and XML formats. Users can test the URL and further understand responses, and can learn to build custom URL requests through provided documentation.\n"]]