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

نموذج طلب واستجابة

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

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