Routes API – Übersicht

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

Vorteile der Routes API

Mit der Routes API können Sie genaue Routen und Fahrtinformationen anhand von Transportdetails, aktuellen Verkehrs- und Straßenverhältnissen sowie Routeneinstellungen abrufen:

  • Art und Funktionen der verschiedenen Mobilitätsformen

  • In welche Richtung ein Fahrzeug geht

  • am Straßenrand, um ein- und aussteigen zu können

  • Verkehrslage und Straßensperrungen

  • Sicherheitsbedenken wie die Vermeidung 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 den Anforderungen Ihrer Routen entsprechend ausgleichen.

Sie können auch die effizientesten Routen für die Dispositionsplanung bestimmen, z. B.:

  • Wie Sie am besten eine Gruppe von Mitarbeitern zuweisen, die eine Reihe von Paketen abholen

  • Das beste Lager auswählen, von dem Pakete an ihren Bestimmungsort gesendet werden

Was kann ich mit der Routes API tun?

Mit der Routes API können Sie zwei primäre Kategorien von Routinginformationen abrufen:

  • Routen von einem Standort zu einem oder mehreren Zielen

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

Routen für ein oder mehrere Ziele abrufen

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

  • Rufen Sie Wegbeschreibungen für verschiedene Verkehrsmittel und für ein oder mehrere Ziele ab:

    • Mobilitätsformen, z. B. öffentliche Verkehrsmittel, Auto, Zweiräder, zu Fuß oder mit dem Fahrrad.

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

  • Es gibt mehrere Möglichkeiten, Start- und Zielorte sowie Wegpunkte anzugeben:

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

    • Orts-IDs

    • Breiten- und Längengradkoordinaten, optional mit Fahrzeugausrichtung

  • Optimieren Sie Ihre Routenoptionen anhand Ihrer Anforderungen und Ziele:

  • Steuern Sie Ihre Latenz und Qualität, indem Sie über eine Feldmaske nur die Daten anfordern, die Sie benötigen. So vermeiden Sie unnötige Verarbeitungszeit und höhere Gebühren für Anfragen. Weitere Informationen finden Sie unter Auswählen, welche Informationen zurückgegeben werden sollen.

Matrix möglicher Routen abrufen

Die Compute Route Matrix-Methode der Routes API bietet eine Matrix mit Informationen zu empfohlenen Routen zwischen mehreren Start- und Endpunkten, einschließlich Entfernung und geschätzter Ankunftszeit, damit Sie die besten Start- und Zielorte für Ihre Geschäftsanforderungen auswählen können. Sie können folgende Arten von Entfernungsdaten anfordern:

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

  • Strecke in Kilometern oder Meilen

  • Geschätzte Reisezeit bei starker Verkehrslage

Mit den Entfernungsdaten können Sie die effizienteste Methode ermitteln, um Passagiere, Lieferungen oder Arbeitskräfte zwischen mehreren möglichen Start- und Zielorten weiterzuleiten.

Sie können Elemente der Antwort streamen, bevor die gesamte Matrix berechnet wurde. Dadurch wird die Antwortlatenz verringert.

Sie können pro serverseitiger Anfrage mehrere Start- und Zielorte angeben. Dabei wird die Anzahl der Startorte multipliziert mit der Anzahl der Ziele (bis zu 625) angegeben.

Funktionsweise der Routes API

Die Routes API bietet zwei Methoden: ComputeRoute und ComputeRouteMatrix.

ComputeRoute

Die Methode ComputeRoute 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 zur Angabe der Felder, die 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 von Ihnen angeforderten Felder zurück.

ComputeRouteMatrix

Die Routes API ComputeRouteMatrix akzeptiert HTTP-POST-Anfragen mit einem JSON-Anfragetext, der die Anfragedetails enthält. Erforderlich sind mindestens ein Abflugort, zwei oder mehr Reiseziele, „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 aus allen Start- und Ziel-Wegpunkten.

Ressourcen

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

Datenressourcen Zurückgegebene Daten Rückgabeformat
ComputeRoute Gibt Routen, Streckenabschnitte und Schritte für eine Route zurück, mit alternativen Routen, falls angefordert. JSON
ComputeRouteMatrix Gibt ein Array mit Routen von einem Ursprungs-Wegpunkt zu einem Ziel-Wegpunkt zurück.

Routes API verwenden

1 Jetzt einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung für die Einrichtung.
2 Route berechnen und die Antwort prüfen Weitere Informationen finden Sie unter Route berechnen und Routenantworten ansehen.
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