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 anhand von Transportdetails, aktuellen Verkehrs- und Straßenverhältnissen sowie Routeneinstellungen genaue Routen- und Fahrtinformationen abrufen:

  • Arten und Funktionen der verschiedenen Mobilitätsformen

  • In welche Richtung ein Fahrzeug geht

  • Der Straßenrand zum Ein- und Aussteigen

  • Verkehrslage und Straßensperrungen

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

  • Mit optionalen Features wie Mautstraßen und Fahrtmetadaten wie Zeit, Entfernung und Kraftstoffeffizienz können Sie Latenz, Qualität und Kosten auf Ihre Routenanforderungen abstimmen.

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

  • Wie Sie am besten eine Gruppe von Mitarbeitern zur Abholung einer Reihe von Paketen zuweisen

  • Das beste Lager auswählen, von dem aus Pakete an ihr endgültiges Ziel verschickt werden sollen

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

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 wie öffentliche Verkehrsmittel, Auto, Motorrad, 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, Startorte, Zielorte und 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 Richtung des Fahrzeugs

  • Optimieren Sie Ihre Routenoptionen anhand Ihrer Anforderungen und Ziele:

  • Kontrollieren Sie Ihre Latenz und Qualität, indem Sie mithilfe einer Feldmaske nur die Daten anfordern, die Sie wirklich benötigen. So vermeiden Sie unnötige Verarbeitungszeiten und höhere Kosten 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 für empfohlene Routen zwischen mehreren Start- und Endpunkten, einschließlich Entfernung und geschätzter Ankunftszeit. So können Sie die besten Start- und Zielorte für Ihre geschäftlichen Anforderungen auswählen. Sie können folgende Arten von Entfernungsdaten anfordern:

  • Strecke 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, wodurch die Antwortlatenz verringert wird.

Sie können pro serverseitiger Anfrage mehrere Start- und Zielorte angeben. Dabei ergibt sich maximal 625 aus der Anzahl der Startorte multipliziert mit der Anzahl der Ziele.

Funktionsweise der Routes API

Die Routes API hat zwei Methoden: ComputeRoutes und ComputeRouteMatrix.

ComputeRoutes

Die Methode ComputeRoutes 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 festzulegen, 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 Abflugort, mindestens zwei Reiseziele, „travelMode“ und eine Feldmaske, um festzulegen, 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 und die zurückgegebenen Daten zusammengefasst.

Datenressourcen Zurückgegebene Daten Rückgabeformat
ComputeRoutes Gibt Routen, Streckenabschnitte und Schritte für eine Route mit alternativen Routen zurück, 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 zur 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 überprüfen Weitere Informationen finden Sie unter Routenmatrix abrufen und Antwort der Routenmatrix prüfen.

Verfügbare Clientbibliotheken

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

Nächste Schritte