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

<DistanceMatrixResponse>
 <status>OK</status>
 <origin_address>Washington, DC, USA</origin_address>
 <destination_address>New York, NY, USA</destination_address>
 <row>
  <element>
   <status>OK</status>
   <duration>
    <value>14078</value>
    <text>3 hours 55 mins</text>
   </duration>
   <distance>
    <value>367654</value>
    <text>228 mi</text>
   </distance>
  </element>
 </row>
</DistanceMatrixResponse>

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