Routes API – Übersicht

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

Vorteile der Routes API

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

  • Art und Möglichkeiten 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 Abholorte

  • Mit optionalen Funktionen wie Mautgebühren und Fahrtmetadaten wie Zeit und Entfernung sowie Kraftstoffverbrauch lassen sich Latenz, Qualität und Kosten für Ihre Routenplanung optimieren.

Sie können auch die effizientesten Routen für die Dispatch-Planung ermitteln, z. B.:

  • Wie Sie am besten Mitarbeitern die Abholung einer Reihe von Paketen zuweisen

  • Das beste Lager ermitteln, von dem aus Pakete an ihr endgültiges Ziel versendet werden sollen

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 Zielorten.

Routen für ein oder mehrere Ziele abrufen

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:

    • Verkehrsmittel, einschließlich öffentlicher Verkehrsmittel, Autos, Zweiräder, zu Fuß oder mit dem Fahrrad

    • Eine Reihe von Wegpunkten, die Sie für die effizienteste Reihenfolge optimieren können.

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

    • Textstrings 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 Fahrzeugkurs

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

  • Stellen Sie die Latenz und Qualität ein, indem Sie mithilfe einer Feldmaske nur die Daten anfordern, die Sie benötigen. So vermeiden Sie unnötige Verarbeitungszeiten und höhere Abrechnungsraten für Anfragen. Weitere Informationen finden Sie unter Zurückzugebende Informationen auswählen.

Matrix mit möglichen Routen abrufen

Die Compute Route Matrix-Methode der Routes API bietet eine Matrix mit Informationen zu empfohlenen Routen zwischen mehreren Start- und Zielpunkten, einschließlich Entfernung und geschätzter Ankunftszeiten. So können Sie die besten Start- und Zielorte basierend auf Ihren Geschäftsanforderungen auswählen. 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

Anhand der Entfernungsdaten können Sie die effizienteste Route für Passagiere, Lieferungen oder Mitarbeiter zwischen mehreren möglichen Start- und Zielorten ermitteln.

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

Sie können mehrere Start- und Zielorte pro serverseitiger Anfrage angeben, wobei die Anzahl der Start- und Zielorte bis zu 625 betragen kann.

Funktionsweise der Routes API

Die Routes API hat 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 ein Start- und Zielort, der Verkehrsmitteltyp 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. Es sind mindestens ein Startort, zwei oder mehr Ziele, „travelMode“ und eine Feldmaske erforderlich, um anzugeben, 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 Start- und Ziel-Wegpunkte.

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, Abschnitte und Schritte für eine Route zurück, gegebenenfalls mit alternativen Routen. JSON
ComputeRouteMatrix Gibt ein Array von Routen von einem Start- zu einem Ziel-Wegpunkt 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 abrufen und Routenantworten überprüfen.
3 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