بدء استخدام Distance 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 بمفتاح واجهة برمجة التطبيقات الفعلي. يعرض الردّ المسافة والمدة بين نقاط الانطلاق والوجهات المحدّدة.

تعرَّف على كيفية إنشاء عناوين 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


 OK
 Washington, DC, USA
 New York, NY, USA
 
  
   OK
   
    14078
    3 hours 55 mins
   
   
    367654
    228 mi

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