بدء استخدام 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
   
  
 

اطّلِع على دليل المطوّرين لفهم الاستجابة.