بدء استخدام واجهة برمجة التطبيقات لمصفوفة المسافات

نموذج طلب وردّ

يطلب هذا المثال بيانات مصفوفة المسافة بين واشنطن العاصمة ومدينة نيويورك، نيويورك، بتنسيق 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 بمفتاح واجهة برمجة التطبيقات الفعلي. تعرض الاستجابة المسافة والمدة بين الأصول والوجهات المحددة.

اطّلِع على طريقة إنشاء عناوين 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>

يُرجى الاطّلاع على دليل المطوّر لفهم الردّ.