Navigationspunkte

Entwickler im Europäischen Wirtschaftsraum (EWR)

Das Feld navigation_points in der Geocoding-Antwort enthält eine Liste von Punkten, die für die Navigation zum Ort nützlich sind. Sie sollten entweder als Start- oder Endpunkte verwendet werden, wenn Sie auf einem Straßennetz von oder zu einem Ort navigieren. Jeder Navigationspunkt enthält die folgenden Werte:

  • location enthält den Wert für Breiten- und Längengrad des Navigationspunkts. Dieser Ort befindet sich immer in unmittelbarer Nähe des Straßennetzes und ist ein idealer Start- oder Endpunkt für die Navigation zu und von einem Ort. Der Punkt ist absichtlich leicht von der Mittellinie der Straße versetzt, um die Straßenseite, auf der sich der Ort befindet, deutlich zu kennzeichnen.
  • restricted_travel_modes ist eine Liste der Mobilitätsformen, mit denen der Navigationspunkt nicht erreichbar ist:
    • "DRIVE" ist die Mobilitätsform für die Wegbeschreibung für Autofahrer.
    • "WALK" ist die Mobilitätsform für die Wegbeschreibung für Fußgänger.
  • road_name enthält den Namen der Straße, von der der Navigationspunkt versetzt ist.

Navigationspunkte werden für die meisten Orte mit einer genauen Position zurückgegeben, z. B. für Adressen, Gebäude und Unternehmen. Bei Orten, die große Gebiete wie Städte und Regionen darstellen, bei denen eine genaue Position mehrdeutig sein kann , werden möglicherweise keine Navigationspunkte zurückgegeben.

Migrationshinweis

Ab dem 17. April müssen Sie den Parameter NAVIGATION_POINTS für zusätzliche Berechnungen in der Anfrage angeben, um Navigationspunkte zu erhalten. Sie können dies testen, indem Sie prüfen, ob das Feld road_name in einigen Navigationspunkten zurückgegeben wird und ob das Feld location in jedem Navigationspunkt die folgenden vier Unterfelder enthält: lat, lng, latitude und longitude.

Außerdem müssen Sie zu den Feldern location.lat und location.lng migrieren und nicht mehr die Felder location.latitude und location.longitude verwenden. In einer zukünftigen Version enthalten Antworten auf Anfragen, die den Parameter NAVIGATION_POINTS für zusätzliche Berechnungen nicht enthalten, keine Navigationspunkte. Die Felder location.latitude und location.longitude werden dann nicht mehr zurückgegeben.

Anfragedetails

Sie können Navigationspunkte in den folgenden Arten von Anfragen abrufen:

Für alle diese Anfragen geben Sie diesen Parameter an: extra_computations=NAVIGATION_POINTS.

Beispielanfrage

Die folgende Abfrage verwendet die Geocodierung von Orten, um Navigationspunkte für ein Restaurant in Mountain View, Kalifornien, USA, abzurufen:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJZ54APTS3j4ARBYZD956MHq8&extra_computations=NAVIGATION_POINTS&key=YOUR_API_KEY

Beispielantwort

Die Antwort auf die obige Abfrage zeigt ein Array von Navigationspunkten:

{
  "navigation_points": [
    {
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Castro Street"
    },
    {
      "location": {
        "lat": 37.394273,
        "lng": -122.0793078,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Wild Cherry Lane"
    },
    {
      "location": {
        "lat": 37.3941202,
        "lng": -122.0789189,
      },
      "restricted_travel_modes": ["DRIVE"]
    }
  ]
}

Feedback

Dies ist eine experimentelle Funktion. Wir freuen uns über Feedback unter geocoding-feedback-channel@google.com.