نمونه درخواست و پاسخ
این مثال داده های ماتریس فاصله بین واشنگتن، دی سی و شهر نیویورک، نیویورک را در قالب 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 -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'
جاوا اسکریپت
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);
});پایتون
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)جاوا
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();روبی
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برو
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 نیز به عنوان مجموعه پستچی موجود است.
در Postman اجرا شود آن را امتحان کنید! این درخواست را با وارد کردن URL در مرورگر وب خود آزمایش کنید - مطمئن شوید که YOUR_API_KEY با کلید API واقعی خود جایگزین کنید. پاسخ فاصله و مدت زمان بین مبدا و مقصد مشخص شده را نشان می دهد.
با نحوه ساخت 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 برای این API منتشر شده و در GitHub در دسترس است.
مشخصات OpenAPI را دریافت کنیدمجموعه پستچی
مشخصات OpenAPI نیز به عنوان مجموعه پستچی موجود است.
در Postman اجرا شودبرای درک پاسخ، راهنمای توسعه‌دهنده را بررسی کنید.