תחילת השימוש ב-מרחק 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
   
  
 

כדאי לעיין במדריך למפתחים כדי להבין את התשובה.