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