Punkty nawigacyjne

Pole navigation_points w odpowiedzi interfejsu Geocoding zawiera listę punktów, które są przydatne do nawigacji do danego miejsca. W szczególności powinny być używane jako punkty początkowe lub końcowe podczas wyznaczania trasy w sieci drogowej do lub z danego miejsca. Każdy punkt nawigacji zawiera te wartości:

  • location zawiera szerokość i długość geograficzną punktu nawigacyjnego. Ta lokalizacja będzie zawsze bardzo blisko sieci drogowej i stanowi idealny punkt początkowy lub końcowy nawigacji do lub z danego miejsca. Punkt jest celowo nieco przesunięty od osi drogi, aby wyraźnie zaznaczyć, po której stronie drogi znajduje się miejsce.
  • restricted_travel_modes to lista trybów podróży, w których punkt nawigacji jest niedostępny:
    • "DRIVE" to środek transportu odpowiadający wskazówkom dojazdu.
    • "WALK" to środek transportu odpowiadający trasie pieszej.
  • road_name zawiera nazwę drogi, od której jest przesunięty punkt nawigacyjny.

Punkty nawigacyjne są zwracane w przypadku większości miejsc o dokładnej lokalizacji, takich jak adresy ulic, budynki i obiekty. Miejsca, które reprezentują duże obszary, takie jak miasta i regiony, gdzie dokładna lokalizacja może być niejednoznaczna, mogą nie zwracać żadnych punktów nawigacji.

Powiadomienie o migracji

Od 17 kwietnia, aby otrzymywać punkty nawigacyjne, musisz w prośbie podać dodatkowy parametr NAVIGATION_POINTScomputations. Klienci mogą to sprawdzić, potwierdzając, że pole road_name w niektórych punktach nawigacji jest zwracane i że pole location w każdym punkcie nawigacji ma 4 pole podrzędne (lat, lng, latitude, longitude).

Musisz też przenieść dane do pól location.lat i location.lng, a nie do pól location.latitude i location.longitude. W przyszłej wersji żądania, które nie zawierają parametru NAVIGATION_POINTS z dodatkowymi obliczeniami, nie będą zawierać w odpowiedzi żadnych punktów nawigacji, a pola location.latitude i location.longitude nie będą już zwracane.

Szczegóły prośby

Punkty nawigacyjne możesz uzyskać w ramach tych typów żądań:

W przypadku każdej z tych próśb musisz podać parametr extra_computations=NAVIGATION_POINTS.

Przykładowe żądanie

W tym zapytaniu do uzyskania punktów nawigacyjnych restauracji w Mountain View w Kalifornii w Stanach Zjednoczonych użyto gekodowania miejsca:

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

Przykładowa odpowiedź

Odpowiedź na zapytanie powyżej zawiera tablicę punktów nawigacyjnych:

{
  "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"]
    }
  ]
}

Prześlij opinię

To funkcja eksperymentalna. Prześlij swoją opinię na adres geocoding-feedback-channel@google.com.