Memulai Distance Matrix API

Contoh permintaan dan respons

Contoh ini meminta data matriks jarak antara Washington, DC dan New York City, NY, dalam format 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

Catatan: Cuplikan yang dihasilkan dari spesifikasi OpenAPI pada GitHub.

URLC

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'

Catatan: Cuplikan yang dihasilkan dari spesifikasi OpenAPI pada GitHub.

JavaScript

Untuk melakukan panggilan di lingkungan browser, gunakan Maps JavaScript API.

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);
});

Catatan: Cuplikan yang dihasilkan dari spesifikasi OpenAPI pada 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)

Catatan: Cuplikan yang dihasilkan dari spesifikasi OpenAPI pada 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();

Catatan: Cuplikan yang dihasilkan dari spesifikasi OpenAPI pada 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

Catatan: Cuplikan yang dihasilkan dari spesifikasi OpenAPI pada GitHub.

Go

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))
}

Catatan: Cuplikan yang dihasilkan dari spesifikasi OpenAPI pada GitHub.

Tukang pos

Spesifikasi OpenAPI juga tersedia sebagai koleksi Postman.

Jalankan di Postman

Cobalah Uji permintaan ini dengan memasukkan URL ke browser web Anda - pastikan untuk mengganti YOUR_API_KEY dengan kunci API Anda yang sebenarnya. Respons ini menunjukkan jarak dan durasi antara tempat asal dan tujuan yang ditentukan.

Pelajari cara mem-build URL permintaan, termasuk semua parameter yang tersedia.

Contoh kode ini dalam format JSON dan 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>

Spesifikasi OpenAPI

Spesifikasi OpenAPI dipublikasikan untuk API ini dan tersedia di GitHub.

Dapatkan Spesifikasi OpenAPI

Koleksi Tukang Pos

Spesifikasi OpenAPI juga tersedia sebagai koleksi Postman.

Jalankan di Postman

Lihat panduan developer untuk memahami respons.