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 erhalten Sie genaue Routen und Fahrtinformationen mit Transportdetails, aktuellen Verkehrs- und Straßenbedingungen sowie Routeneinstellungen:

  • Art und Funktionen der verschiedenen Mobilitätsformen

  • In welche Richtung ein Fahrzeug fährt

  • Die Seite der Straße für Abhol- und Ausstiege

  • 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 Methode Compute Routes der Routes API können Sie unterschiedliche Standorte berechnen:

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

    • Mobilitätsformen, einschließlich öffentlicher Verkehrsmittel, Auto, Zweiradfahrzeuge, Fußgänger oder Radfahrer.

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

  • Mehrere Möglichkeiten zur Angabe von Startorten, Zielorten und Wegpunkten:

    • 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 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 Auswählen, welche Informationen zurückgegeben werden sollen.

Matrix der möglichen Routen abrufen

Mit der Compute Route Matrix-Methode 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. 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:

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

  • Entfernung in Kilometern oder Meilen

  • Geschätzte Fahrtzeit bei starkem Verkehr

Mithilfe der Entfernungsdaten können Sie die effizienteste Methode zur Routenführung von Passagieren, Lieferungen oder Arbeitern zwischen mehreren möglichen Start- und Zielorten ermitteln.

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

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 Methode ComputeRoutes der Routes API akzeptiert eine HTTP-POST-Anfrage mit einem JSON-Anfragetext, der die Anfragedetails enthält. Erforderlich sind die Felder „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 von Ihnen angeforderten Felder zurück.

ComputeRouteMatrix

Die ComputeRouteMatrix der Routes API 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.

Weitere Informationen

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

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

Routes API verwenden

1 Jetzt einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung unten.
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 Routenmatrix-Antwort prüfen.

Verfügbare Clientbibliotheken

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

Nächste Schritte