Navigationspunkte

Das Feld navigation_points in der Geocodierungsantwort enthält eine Liste von Punkten, die für die Navigation zum Ort nützlich sind. Sie sollten insbesondere als Start- oder Endpunkt für die Routenplanung in einem Straßennetz von oder zum Ort verwendet werden. Jeder Navigationspunkt enthält die folgenden Werte:

  • location enthält die Werte für Breiten- und Längengrad des Navigationspunkts. Dieser Standort befindet sich immer in unmittelbarer Nähe zum Straßennetz und ist ein idealer Ausgangspunkt 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 zu markieren, an der sich der Ort befindet.
  • restricted_travel_modes ist eine Liste der Mobilitätsformen, mit denen der Navigationspunkt nicht erreichbar ist:
    • "DRIVE" ist die Mobilitätsform, die der Wegbeschreibung für Pkw entspricht.
    • "WALK" ist die Mobilitätsform für Fußgängerrouten.
  • road_name enthält den Namen der Straße, von der der Navigationspunkt versetzt ist.

Navigationspunkte werden für die meisten Orte mit einem genauen Standort zurückgegeben, z. B. für Straßenadressen, Gebäude und Einrichtungen. Für Orte, die große Gebiete wie Städte und Regionen darstellen, bei denen der genaue Standort nicht eindeutig ist, werden möglicherweise keine Navigationspunkte zurückgegeben.

Hinweis zur Migration

Ab dem 17. April müssen Sie den Parameter NAVIGATION_POINTS extra calculations in der Anfrage angeben, um Navigationspunkte zu erhalten. Kunden können dies testen, indem sie prüfen, ob das Feld „road_name“ in einigen Navigationspunkten zurückgegeben wird und das Feld „location“ in jedem Navigationspunkt die folgenden vier Unterfelder enthält (lat, lng, latitude, longitude).

Außerdem müssen Sie zu den Feldern location.lat und location.lng migrieren, anstatt zu den Feldern location.latitude und location.longitude. In einem zukünftigen Release enthalten Anfragen, die den Parameter NAVIGATION_POINTS für zusätzliche Berechnungen nicht enthalten, keine Navigationspunkte in der Antwort und die Felder location.latitude und location.longitude werden nicht mehr zurückgegeben.

Anfragedetails

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

Für jede dieser Anfragen geben Sie diesen Parameter an: extra_computations=NAVIGATION_POINTS.

Beispielanfrage

In der folgenden Abfrage wird das Geocoding von Orten verwendet, um Navigationspunkte für ein Restaurant in Mountain View, Kalifornien, USA, zu erhalten:

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 enthält ein Array mit 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 Ihr Feedback unter geocoding-feedback-channel@google.com.