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

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

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

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