Routenzusammenfassung berechnen

So berechnen Sie mit Text Search (New) oder Nearby Search (New) die Reisedauer und ‑strecke zu jedem Ort in der Antwort:

1. Übergeben Sie den routingParameters.origin Parameter in der Anfrage, um die Breiten- und Längengradkoordinaten des Routenursprungs anzugeben. Dieser Parameter ist erforderlich, um die Dauer und Entfernung zu jedem Ort in der Antwort zu berechnen.

2. Fügen Sie routingSummaries in die Feldmaske ein, damit die Antwort das routingSummaries Array enthält. Dieses Array enthält die Dauer und Entfernung vom Routenursprung zu jedem Ort in der Antwort.

Mit dem APIs Explorer können Sie Live-Anfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen:

Text Search (New) verwenden

In der folgenden Anfrage berechnen Sie die Reisedauer und ‑strecke zu jedem Ort in der Antwort von Text Search (New):

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
  "routingParameters": {
    "origin": {
      "latitude": -33.8688,
      "longitude": 151.1957362
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
'https://places.googleapis.com/v1/places:searchText'

Die Antwort enthält zwei JSON-Arrays: Das Array places enthält die übereinstimmenden Orte und das Array routingSummaries die Dauer und Entfernung zu jedem Ort:

{
  "places": [
    {
      object (Place)
    }
  ]
  "routingSummaries": [
    {
      object (RoutingSummary)
    }
}

Jedes Element im Array routingSummaries befindet sich an der entsprechenden Array-Position wie der Ort im Array places. Das Element unter routingSummaries[0] entspricht also dem Ort unter places[0].

Die Array-Länge von routingSummaries ist mit der Array-Länge von places identisch. Wenn die routingSummary für einen Ort nicht verfügbar ist, ist der Array-Eintrag leer.

Da in diesem Beispiel die Dauer und Entfernung vom Routenursprung zu jedem Ort berechnet werden, enthält das Feld routingSummaries.legs in der Antwort ein einzelnes Leg-Objekt mit der duration und distanceMeters vom Routenursprung zum Ort.

{
  "places": [
    {
      "formattedAddress": "1, Westfield Sydney Central Plaza, 450 George St, Sydney NSW 2000, Australia",
      "displayName": {
        "text": "Gözleme King Sydney",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    …
  ]
  "routingSummaries": [
    {
      "legs": [
        {
          "duration": "597s",
          "distanceMeters": 2607
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/-33.8688,151.1957362/''/data=!4m6!4m5!1m0!1m2!1m1!1s0x6b12ae3fa97cd745:0x6aecf365bf497c08!3e0"
    },
    {
      "legs": [
        {
          "duration": "562s",
          "distanceMeters": 2345
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/-33.8688,151.1957362/''/data=!4m6!4m5!1m0!1m2!1m1!1s0x6b12ae3da97f60c1:0x845f3273bd764f6c!3e0"
    },
   …
  ]
}

In diesem Beispiel sehen Sie, dass die Dauer und Entfernung vom Routenursprung zum ersten Ort in den Ergebnissen 597 Sekunden und 2.607 Meter beträgt.

Nearby Search verwenden

In diesem Beispiel berechnen Sie die Reisedauer und ‑strecke zu jedem Ort in der Antwort von Nearby Search. In diesem Beispiel wird nach Restaurants in Sydney, Australien, gesucht und die Standortbeschränkung und der Routenursprung auf dieselben Breiten- und Längengradkoordinaten festgelegt:

  curl -X POST -d '{
    "includedTypes": ["restaurant"],
    "maxResultCount": 10,
    "locationRestriction": {
      "circle": {
        "center": {
          "latitude": -33.8688,
          "longitude": 151.1957362},
        "radius": 500.0
      }
    },
    "routingParameters": {
      "origin": {
        "latitude": -33.8688,
        "longitude": 151.1957362
      }
    }
  }' \
  -H 'Content-Type: application/json' -H "X-Goog-Api-Key:API_KEY" \
  -H "X-Goog-FieldMask: places.displayName,routingSummaries" \
  https://places.googleapis.com/v1/places:searchNearby

Sie müssen nicht dieselben Koordinaten für die locationRestriction und den Routenursprung verwenden. Sie können beispielsweise die locationRestriction auf den Mittelpunkt von Sydney festlegen, um die Suchergebnisse auf diesen Kreis zu beschränken. Anschließend legen Sie den Routenursprung auf die Koordinaten Ihres Hauses fest, also auf einen anderen Ort innerhalb des Suchkreises. Die Anfrage beschränkt die Suchergebnisse dann auf den Kreis und berechnet die Routenzusammenfassungen basierend auf dem Standort Ihres Hauses.

Reiseoptionen angeben

Standardmäßig werden die Dauer- und Entfernungsberechnungen für ein Auto durchgeführt. Sie können jedoch den Fahrzeugtyp sowie andere Optionen in der Suche festlegen.

• Verwenden Sie den Parameter routingParameters.travelMode, um den Reisemodus auf DRIVE, BICYCLE, WALK, oder TWO_WHEELER festzulegen. Weitere Informationen zu diesen Optionen finden Sie unter Verfügbare Fahrzeugtypen für Routen.

• Verwenden Sie die Eigenschaft routingParameters.routingPreference, um die Option für die Routen präferenz auf TRAFFIC_UNAWARE (Standard), TRAFFIC_AWARE oder TRAFFIC_AWARE_OPTIMAL festzulegen. Jede Option hat unterschiedliche Datenqualitäten und Latenzen. Weitere Informationen finden Sie unter Festlegen, wie und ob Verkehrsdaten einbezogen werden sollen.

  Die Eigenschaft routingParameters.routingPreference wirkt sich auf die Wegbeschreibung im Feld directionsUri der Vorabversion (pre-GA) aus, da Google Maps Verkehrsoptionen anzeigt, wenn der Link geöffnet wird.

• Verwenden Sie die Eigenschaft routingParameters.routeModifiers, um avoidTolls, avoidHighways, avoidFerries und avoidIndoor anzugeben. Weitere Informationen zu diesen Optionen finden Sie unter Routenfunktionen angeben, die vermieden werden sollen.

Im nächsten Beispiel legen Sie den Reisemodus auf DRIVE fest und geben an, dass Autobahnen vermieden werden sollen:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
  "routingParameters": {
    "origin": {
      "latitude": -33.8688,
      "longitude": 151.1957362
    },
    "travelMode":"DRIVE",
    "routeModifiers": {
      "avoidHighways": true
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
'https://places.googleapis.com/v1/places:searchText'

Testen!

Mit dem APIs Explorer können Sie Beispielanfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen.

1. Wählen Sie rechts auf der Seite das API-Symbol api aus.

2. Optional können Sie die Anfrageparameter bearbeiten.

3. Wählen Sie die Schaltfläche Ausführen aus. Wählen Sie im Dialogfeld das Konto aus, mit dem Sie die Anfrage stellen möchten.

4. Wählen Sie im APIs Explorer-Bereich das Vollbildsymbol fullscreen aus, um das APIs Explorer-Fenster zu maximieren.