با Distance Matrix API شروع کنید

نمونه درخواست و پاسخ

این مثال داده‌های ماتریس فاصله بین واشنگتن دی سی و نیویورک سیتی، نیویورک را در قالب JSON درخواست می‌کند:

آدرس اینترنتی

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 -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 است:

جی‌سون

{
  "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>

برای درک پاسخ، راهنمای توسعه‌دهنده را بررسی کنید.