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

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

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

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