Routes API – Übersicht

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

Vorteile der Routes API

Mit der Routes API erhalten Sie genaue Routen und Fahrtinformationen mit Verkehrsinformationen, aktuellen Verkehrs- und Straßenbedingungen sowie Einstellungen:

  • 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 sichere Abholung Regionen

  • Ausgleichen Sie Latenz, Qualität und Kosten auf Ihre Routinganforderungen mit optionalen Funktionen wie Mautgebühren und Fahrtmetadaten wie Zeit und Entfernung sowie Benzin Effizienz

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

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

  • Das beste Warenlager für den Versand der Pakete bestimmen Ziel

Was kann ich mit der Routes API tun?

Mit der Routes API erhalten Sie zwei Hauptkategorien für Routen Informationen:

  • 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 zwischen Standorten berechnen:

  • Routen für verschiedene Fortbewegungsarten und für eine oder mehrere Routen berechnen lassen Ziele:

    • Mobilitätsformen, einschließlich Transit, Auto, Motorrad, zu Fuß oder mit dem Fahrrad.

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

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

    • Textzeichenfolgen. Beispiel: „Chicago, IL“, „Darwin, NT, Australia“, „1800 Amphitheatre Parkway, Mountain View, CA 94043, USA“ 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 nur die Daten anfordern, die Sie benötigen. eine Feldmaske, mit der Sie unnötige Verarbeitungszeiten und Abrechnungstarife anfordern. Weitere Informationen finden Sie unter Wählen Sie aus, welche Informationen zurückgegeben werden sollen.

Matrix mit möglichen Routen abrufen

Die Methode Compute Route Matrix der Routes API bietet ein Informationsmatrix für empfohlene Routen zwischen mehreren Start- und Endpunkten Punkte, wie Entfernung und geschätzte Ankunftszeit, an, um Ihnen die Auswahl besten Start- und Zielorten basierend auf Ihren Geschäftsanforderungen. 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

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

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

Sie können mehrere Start- und Zielorte pro serverseitiger Anfrage angeben: die Anzahl der Startorte multipliziert mit der Anzahl der Ziele bis 625.

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 Einen JSON-Anfragetext, der die Anfragedetails enthält. Erforderlich sind ein Ursprung, "destination", "travelMode" und eine Feldmaske zur Angabe der zurückzugebenden Felder.

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

ComputeRouteMatrix

Die Routes API ComputeRouteMatrix akzeptiert eine HTTP-POST-Anfrage mit Einen JSON-Anfragetext, der die Anfragedetails enthält. Erforderlich sind mindestens eins „origin“, zwei oder mehr Ziele, „travelMode“ und eine Feldmaske zur Angabe des Felder, die 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 Startorte und Ziel-Wegpunkte.

Ressourcen

In der folgenden Tabelle sind die Ressourcen aufgeführt, die über die Routes API zusammen mit den zurückgegebenen Daten an.

Datenressourcen Zurückgegebene Daten Rückgabeformat
ComputeRoutes Gibt Routen, Streckenabschnitte und Schritte für eine Route zurück, einschließlich alternativer Routen. wenn Sie dazu aufgefordert werden. JSON
ComputeRouteMatrix Gibt ein Array von Routen von einem Ausgangswegpunkt zu einem Ziel zurück Wegpunkt.

Routes API verwenden

1 Einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung zur Einrichtung.
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 Prüfen Sie die Route Matrix-Antwort.

Verfügbare Clientbibliotheken

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

Nächste Schritte