Route zu Navigationspunkten

Das Navigation SDK for Android bietet erweiterte Möglichkeiten zum Angeben von Wegpunkten oder Navigationspunkten. So können Sie genauere Routen erstellen und die Ankunft am Zielort verbessern, insbesondere bei Zielen mit mehreren Eingängen oder bestimmten Navigationspunkten. Sie können Routen zu genauen Standorten erstellen, indem Sie einen navigationPointToken verwenden. Das ist ein String, der einen Standort und zusätzlichen Routenkontext codiert. Sie können auch Breiten- und Längengradkoordinaten mit einer Orts-ID kombinieren, um zusätzlichen Kontext zu erhalten.

Hintergrund

Vor Version 7.4 konnten Sie einen Waypoint entweder mit Breiten- und Längengradkoordinaten oder mit einer Orts-ID definieren. Die Weiterleitung nur an einen Breiten- und Längengrad kann manchmal zu suboptimalen Abhol- oder Abgabeorten führen, insbesondere bei großen Veranstaltungsorten, Parks oder Gebäuden mit mehreren Eingängen. Das Ergebnis wird möglicherweise an das nächstgelegene Straßensegment ausgerichtet, das nicht unbedingt der beste oder richtige Navigationspunkt ist.

Die erweiterten Wegpunktoptionen bieten hier Abhilfe, da sie mehr Kontext ermöglichen.

Navigationspunkt-Token verwenden

Für die genaueste Routenführung zu bestimmten Navigationspunkten wie Eingängen, Laderampen oder ausgewiesenen Abholbereichen können Sie einen navigationPointToken verwenden. Dieses Token wird durch Aufrufen der destinations-Methode der Geocoding API abgerufen. Er stellt einen bestimmten, routingfähigen Navigationspunkt dar, der mit einem Ort verknüpft ist.

So geben Sie ein Navigation Point-Token an:

1. Rufen Sie einen navigationPointToken aus der Antwort der Destinations-Methode der Geocoding API ab.
2. Erstellen Sie mit der Methode setNavigationPointToken() im Builder ein Waypoint.

Hinweis:Wenn Sie setNavigationPointToken() verwenden, können Sie nicht gleichzeitig setLatLng() oder setPlaceIdString() verwenden. Diese Methoden schließen sich gegenseitig mit setNavigationPointToken() aus.

// Assuming 'navPointToken' is a String obtained from the destinations method of the Geocoding API
// Assuming 'destinationName' is a String title for the waypoint

Waypoint waypointWithToken = Waypoint.builder()
    .setTitle(destinationName)
    .setNavigationPointToken(navPointToken)
    .build();

// Use this waypoint in navigator.setDestinations()

Navigationspunkt- und Routentokens verwenden

Sie können ein Navigationspunkt-Token über die Geocoding API und ein Routen-Token über die Routes API abrufen und dann sowohl das Navigationspunkt-Token als auch das Routen-Token an das Navigation SDK übergeben. Das ist in Szenarien wie Mitfahrdiensten oder Lieferdiensten nützlich, in denen Sie die Routes API verwenden, um einen Fahrpreis zu berechnen, und die Genauigkeit eines Navigationspunkt-Tokens benötigen.

Das Routentoken beeinflusst die vom Navigation SDK ausgewählte Route in Richtung der Route, die für die Preisgestaltung verwendet wurde. So wird das Risiko verringert, dass für die Fahrt längere oder kürzere Routen verwendet werden, was zu „Preisschwankungen“ führen kann.

Weitere Informationen zum Angeben eines Orts mit einem Navigationspunkt-Token und zum Erstellen eines Routen-Tokens finden Sie in der Routes API-Dokumentation. Unter Route planen erfahren Sie, wie Sie eine Route mit einem Routentoken planen.

In diesem Diagramm wird gezeigt, wie eine Mitfahr- oder Liefer-App Navigationspunkt-Tokens und Routen-Tokens zusammen verwendet:

Orts-ID und Breiten- und Längengrad kombinieren

Ab Version 7.4 können Sie beim Erstellen eines Waypoint sowohl eine Orts-ID als auch Breiten- und Längengradkoordinaten angeben. Diese Methode ist nützlich, wenn Sie einen genauen Punkt (Breiten-/Längengrad) angeben und gleichzeitig den Kontext des gesamten Orts (die Orts-ID) bereitstellen möchten. So kann das Navigation SDK eine bessere Ankunftserfahrung bieten, indem das Zielgebäude hervorgehoben oder Sehenswürdigkeiten in der Nähe angezeigt werden, die mit der Orts-ID verknüpft sind.

// Assuming 'placeId' is the Place ID String
// Assuming 'lat' and 'lng' are the double values for latitude and longitude
// Assuming 'destinationName' is a String title for the waypoint

Waypoint waypointWithPlaceIdAndLatLng = Waypoint.builder()
    .setTitle(destinationName)
    .setPlaceIdString(placeId)
    .setLatLng(lat, lng)
    .build();

// Use this waypoint in navigator.setDestinations()

Hinweise

Wenn Sie sowohl placeId als auch latlng angeben:

• Die Route ist hauptsächlich auf die angegebene latlng ausgerichtet.
• Die placeId wird als Kontext verwendet, um die Ankunft zu optimieren.
• Fallback:Wenn das SDK feststellt, dass das angegebene placeId zu weit vom angegebenen latlng entfernt ist, wird das placeId ignoriert. In diesem Fall wird das Routing nur zum latlng fortgesetzt und die ortsspezifischen Verbesserungen der Ankunftsbenachrichtigungen sind nicht verfügbar.

Zusammenfassung der gültigen Wegpunktkonfigurationen