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

نموذج لطلب ورد

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

ملاحظة: مقتطفات يتم إنشاؤها من مواصفات OpenAPI على GitHub.

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'

ملاحظة: مقتطفات يتم إنشاؤها من مواصفات OpenAPI على GitHub.

JavaScript

لإجراء مكالمات في بيئة المتصفِّح، استخدِم واجهة برمجة تطبيقات JavaScript للخرائط.

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=Washington%2C%20DC&destinations=New%20York%20City%2C%20NY&units=imperial&key=YOUR_API_KEY',
  headers: { }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

ملاحظة: مقتطفات يتم إنشاؤها من مواصفات OpenAPI على GitHub.

لغة Python

import requests

url = "https://maps.googleapis.com/maps/api/distancematrix/json?origins=Washington%2C%20DC&destinations=New%20York%20City%2C%20NY&units=imperial&key=YOUR_API_KEY"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

ملاحظة: مقتطفات يتم إنشاؤها من مواصفات OpenAPI على GitHub.

لغة Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://maps.googleapis.com/maps/api/distancematrix/json?origins=Washington%2C%20DC&destinations=New%20York%20City%2C%20NY&units=imperial&key=YOUR_API_KEY")
  .method("GET", body)
  .build();
Response response = client.newCall(request).execute();

ملاحظة: مقتطفات يتم إنشاؤها من مواصفات OpenAPI على GitHub.

Ruby

require "uri"
require "net/http"

url = URI("https://maps.googleapis.com/maps/api/distancematrix/json?origins=Washington%2C%20DC&destinations=New%20York%20City%2C%20NY&units=imperial&key=YOUR_API_KEY")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body

ملاحظة: مقتطفات يتم إنشاؤها من مواصفات OpenAPI على GitHub.

البدء

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://maps.googleapis.com/maps/api/distancematrix/json?origins=Washington,%20DC&destinations=New%20York%20City,%20NY&units=imperial&key=YOUR_API_KEY"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

ملاحظة: مقتطفات يتم إنشاؤها من مواصفات OpenAPI على GitHub.

ساعي البريد

تتوفر أيضًا مواصفات OpenAPI كمجموعة Postman.

Run in Postman

جرِّبه الآن اختبر هذا الطلب عن طريق إدخال عنوان 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>

مواصفات OpenAPI

تم نشر مواصفات OpenAPI لواجهة برمجة التطبيقات هذه وهي متاحة على GitHub.

الحصول على مواصفات OpenAPI

مجموعة Postman

تتوفر أيضًا مواصفات OpenAPI كمجموعة Postman.

تشغيل في Postman

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