Routes API – Übersicht

Die Routes API ist ein Dienst, der eine HTTPS-Anfrage akzeptiert und entweder die ideale Route zwischen zwei Standorten oder Entfernungen und Fahrtzeiten für eine Matrix von Routen zwischen unterschiedlichen Start- und Zielorten zurückgibt.

Vorteile der Routes API

Mit der Routes API können Sie genaue Routen und Fahrtinformationen mithilfe von Mobilitätsdetails, aktuellen Verkehrs- und Straßenbedingungen sowie Routeneinstellungen abrufen:

  • Art und Ausstattung der verschiedenen Mobilitätsformen

  • Die Richtung, in die sich ein Fahrzeug bewegt

  • Die Straßenseite für Abhol- oder Bringvorgänge

  • Verkehrslage und Straßensperrungen

  • Sicherheitsbedenken, z. B. das Vermeiden gefährlicher Gebiete oder die Bereitstellung sicherer Abholbereiche

  • Mit optionalen Features wie Mautgebühren und Fahrtmetadaten wie Zeit und Entfernung sowie Kraftstoffeffizienz können Sie Latenz, Qualität und Kosten auf Ihre Routinganforderungen ausgleichen.

Außerdem können Sie die effizientesten Routen für die Dispositionsplanung ermitteln, z. B.:

  • Wie Sie einer Gruppe von Mitarbeitern die Aufgabe zuweisen, eine Reihe von Paketen abzuholen

  • Das beste Warenlager für den Versand der Pakete zum endgültigen Bestimmungsort bestimmen

Was kann ich mit der Routes API tun?

Mit der Routes API können Sie zwei Hauptkategorien von Routinginformationen abrufen:

  • Routen von einem Standort zu einem oder mehreren Zielen

  • Eine Matrix möglicher Routen zwischen vielen Start- und Endpunkten.

Routen für ein oder mehrere Ziele berechnen

Mit der Compute Routes-Methode der Routes API können Sie Folgendes berechnen:

  • Sie können Wegbeschreibungen für verschiedene Verkehrsmittel und für ein oder mehrere Ziele abrufen:

    • Mobilitätsformen, einschließlich öffentlicher Verkehrsmittel, Autos, Motorräder, Fußgänger oder Fahrrad.

    • Eine Reihe von Wegpunkten, die Sie so optimieren können, dass sie möglichst effizient erreicht werden.

  • Mehrere Möglichkeiten, Start- und Zielorte sowie Wegpunkte anzugeben:

    • Textzeichenfolgen. Beispiele: „Chicago, IL“, „Darwin, NT, Australien“, „1800 Amphitheatre Parkway, Mountain View, CA 94043“ oder „CWF6+FWX Mountain View, Kalifornien“

    • Orts-IDs

    • Breiten- und Längengradkoordinaten, optional mit Fahrtrichtung des Fahrzeugs

  • Passen Sie Ihre Routenoptionen an Ihre Anforderungen und Ziele an:

  • Kontrollieren Sie Ihre Latenz und Qualität, indem Sie mithilfe einer Feldmaske nur die benötigten Daten anfordern. So können Sie unnötige Verarbeitungszeiten und höhere Anfragegebühren vermeiden. Weitere Informationen finden Sie unter Zurückzugebende Informationen auswählen.

Matrix der möglichen Routen abrufen

Mit der Methode Compute Route Matrix der Routes API wird eine Matrix mit Informationen für empfohlene Routen zwischen mehreren Start- und Endpunkten bereitgestellt, einschließlich Entfernung und geschätzter Ankunftszeit. Dies erleichtert Ihnen die Auswahl der besten Start- und Zielorte für Ihre geschäftlichen Anforderungen. Sie können folgende Arten von Entfernungsdaten anfordern:

  • Entfernung für eine ausgewählte Mobilitätsform

  • Entfernung in Kilometern oder Meilen

  • Geschätzte Fahrzeit bei Stau

Mithilfe der Entfernungsdaten können Sie die effizienteste Methode ermitteln, um Passagiere, Lieferungen oder Mitarbeiter zwischen mehreren möglichen Start- und Zielorten zu leiten.

Sie können Elemente der Antwort streamen, bevor die gesamte Matrix berechnet wurde, um die Antwortlatenz zu verringern.

Sie können pro serverseitige Anfrage mehrere Start- und Zielorte angeben, wobei sich die Anzahl der Startorte multipliziert mit der Anzahl der Zielorte auf 625 bezieht.

Funktionsweise der Routes API

Die Routes API bietet zwei Methoden: ComputeRoutes und ComputeRouteMatrix.

ComputeRoutes

Die ComputeRoutes-Methode der Routes API akzeptiert eine HTTP-POST-Anfrage mit einem JSON-Anfragetext, der die Anfragedetails enthält. Erforderlich sind „origin“, „destination“, „travelMode“ und eine Feldmaske, um anzugeben, welche Felder zurückgegeben werden sollen.

Beispiel

curl -X POST -d '{
    "origin": {
      "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
    },
    "destination": {
      "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
    },
  "travelMode": "DRIVE"
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
  -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
  'https://routes.googleapis.com/directions/v2:computeRoutes'

Der Dienst berechnet dann die angeforderte Route und gibt die angeforderten Felder zurück.

ComputeRouteMatrix

Die Routes API ComputeRouteMatrix akzeptiert eine HTTP-POST-Anfrage mit einem JSON-Anfragetext, der die Anfragedetails enthält. Erforderlich sind mindestens ein Startort, zwei oder mehr Ziele, „travelMode“ und eine Feldmaske, mit der angegeben wird, welche Felder zurückgegeben werden sollen.

Beispiel

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

Die Antwort enthält die möglichen Routen für die Kombination aller Wegpunkte vom Ausgangs- und Zielort.

Ressourcen

In der folgenden Tabelle sind die über die Routes API verfügbaren Ressourcen zusammen mit den zurückgegebenen Daten zusammengefasst.

Datenressourcen Zurückgegebene Daten Rückgabeformat
ComputeRoutes Gibt Routen, Streckenabschnitte und Schritte für eine Route zurück, gegebenenfalls mit alternativen Routen. JSON
ComputeRouteMatrix Gibt ein Array mit Routen von einem Ausgangswegpunkt zu einem Zielwegpunkt zurück.

Routes API verwenden

1 Einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung.
2 Route berechnen und Antwort prüfen Weitere Informationen finden Sie unter Route berechnen und Routenantworten ansehen.
3 Die Matrix der Routen berechnen und die Antwort prüfen Weitere Informationen finden Sie unter Routenmatrix abrufen und Routenmatrixantwort prüfen.

Verfügbare Clientbibliotheken

Eine Liste der verfügbaren Clientbibliotheken für die Routes API finden Sie unter Clientbibliotheken.

Nächste Schritte