Erste Schritte mit der Distance Matrix API

Beispielanforderung und -antwort

In diesem Beispiel werden die Matrixdaten für Entfernungen zwischen Washington, DC und New York City, NY, im JSON-Format angefordert:

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

Hinweis:Snippets, die aus der OpenAPI-Spezifikation auf GitHub generiert wurden.

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'

Hinweis:Snippets, die aus der OpenAPI-Spezifikation auf GitHub generiert wurden.

JavaScript

Wenn Sie Aufrufe in der Browserumgebung ausführen möchten, verwenden Sie die 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);
});

Hinweis:Snippets, die aus der OpenAPI-Spezifikation auf GitHub generiert wurden.

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)

Hinweis:Snippets, die aus der OpenAPI-Spezifikation auf GitHub generiert wurden.

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

Hinweis:Snippets, die aus der OpenAPI-Spezifikation auf GitHub generiert wurden.

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

Hinweis:Snippets, die aus der OpenAPI-Spezifikation auf GitHub generiert wurden.

Ok

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

Hinweis:Snippets, die aus der OpenAPI-Spezifikation auf GitHub generiert wurden.

Postman

Die OpenAPI-Spezifikation ist auch als Postman-Sammlung verfügbar.

In Postman ausführen

Testen! Testen Sie diese Anfrage. Geben Sie dazu die URL in Ihren Webbrowser ein. Achten Sie darauf, YOUR_API_KEY durch Ihren tatsächlichen API-Schlüssel zu ersetzen. Die Antwort zeigt die Entfernung und Reisezeit zwischen den angegebenen Start- und Zielorten.

Hier erfahren Sie, wie Sie Anfrage-URLs erstellen, einschließlich aller verfügbaren Parameter.

Dieses Codebeispiel hat die Formate JSON und 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-Spezifikation

Die OpenAPI-Spezifikation wurde für diese API veröffentlicht und ist auf GitHub verfügbar.

GetOpen-Spezifikation

Postman-Kollektion

Die OpenAPI-Spezifikation ist auch als Postman-Sammlung verfügbar.

In Postman ausführen

Weitere Informationen finden Sie im Entwicklerhandbuch.