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 mithilfe von Mobilitätsdetails, 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 Abholorte

  • Ausgleichen Sie Latenz, Qualität und Kosten für 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 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 Endpunkten.

Routen für ein oder mehrere Ziele berechnen

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:

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

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

    • 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 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 Zurückzugebende Informationen auswählen.

Matrix der 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 Fahrzeit bei Stau

Mithilfe der Entfernungsdaten können Sie die effizienteste Route ermitteln. Passagiere, Lieferungen oder Arbeitnehmer zwischen mehreren möglichen Herkunftsorten und Ziele.

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 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 angeforderten Felder zurück.

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 Start- 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 Wegpunkt 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 abrufen und Routenantworten überprüfen.
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