Zarządzaj punktami na trasie

Z tego dokumentu dowiesz się, jak zarządzać ustawieniami punktów kontrolnych w aplikacji za pomocą 2 funkcji:

• Ustawienia preferencji dotyczącej strony drogi
• Przesiadka

Ustawianie preferencji dotyczącej strony drogi

Domyślnie Navigation SDK na iOS znajduje najszybszą trasę do punktu orientacyjnego, ale nie gwarantuje to, że użytkownik dotrze do celu po odpowiedniej stronie drogi, np. po tej samej stronie, po której stoi klient kierowcy. Funkcja Preferencja trasy po właściwej stronie drogi pozwala zapewnić, że pojazd dojedzie po właściwej stronie drogi.

Jak to działa

Preferencje dotyczące dojazdu po konkretnej stronie drogi ustawiasz podczas tworzenia punktu kontrolnego dla danego przystanku. Preferencje możesz określić na 2 sposoby.

preferowanie tej samej strony drogi,

Użytkownik podaje współrzędne geograficzne punktu kontrolnego, a następnie ustawia flagę preferSameSideOfRoad wskazującej, że woli dojechać po tej samej stronie drogi co punkt kontrolny – przybliżony do najbliższego chodnika.

(nullable instancetype)initWithLocation:(CLLocationCoordinate2D)location
                                  title:(NSString *)title
                   preferSameSideOfRoad:(BOOL)preferSameSideOfRoad;

Ważna informacja: w niektórych sytuacjach, gdy punkt kontrolny jest przyciągany do krawędzi najbliższej drogi, ta droga może nie być właściwa. Może to być na przykład droga za rogiem, którą jedzie klient korzystający z usługi przewozu osób. Aby temu zapobiec, użyj atrybutu preferredSegmentHeading zamiast atrybutu preferSameSideOfRoad (szczegółowe informacje znajdziesz w następnej sekcji).

Nagłówek preferowanego segmentu

Wprowadź współrzędne geograficzne punktu drogi, a następnie kierunek dojazdu preferredSegmentHeading, który odpowiada kierunkowi ruchu po tej samej stronie drogi co miejsce docelowe.

(nullable instancetype)initWithLocation:(CLLocationCoordinate2D)location
                                  title:(NSString *)title
                preferredSegmentHeading:(int32_t)preferredSegmentHeading;

Pakiet SDK nawigacji wybiera fragment drogi najbliższy waypointowi, który ma kierunek pasa zgodny (w zakresie +/- 55°) z stroną drogi, na której znajduje się waypoint.

Ustawianie preferencji dotyczących przesiadki

W niektórych miejscach użytkownicy nie mogą bezpiecznie zatrzymać się (np. na wyniesionych obszarach, na promach, w miejscach podziemnych i w miejscach o ograniczonym dostępie). Funkcja Przesiadka przenosi punkt kontrolny w pobliższe miejsce, jeśli jego lokalizacja nie jest odpowiednia do zatrzymania się. Gdy ustawisz wartość vehicleStopover na YES, punkt kontrolny zostanie automatycznie przeniesiony w momencie obliczania trasy, jeśli dostępna jest inna lokalizacja.

Jak to działa

Preferencje dotyczące przestoju ustawiasz podczas tworzenia punktu kontrolnego dla tego przystanku. Aby to zrobić, ustaw preferencję dotyczącą przesiadki na GMSNavigationMutableWaypoint, jak pokazano w tym przykładzie:

Swift

let location = CLLocationCoordinate2D(latitude: 47.67, longitude: -122.20)
let waypoint = GMSNavigationMutableWaypoint(location: location, title: "waypoint from location")!
waypoint.vehicleStopover = true
mapView.navigator?.setDestinations([waypoint], routingOptions: routingOptions, callback: {...})

Objective-C

CLLocationCoordinate2D location = CLLocationCoordinate2DMake(47.67, -122.20);
GMSNavigationMutableWaypoint *waypoint =
    [[GMSNavigationMutableWaypoint alloc] initWithLocation:location
                                                     title:@"waypoint from location"];
waypoint.vehicleStopover = YES;
[_mapView.navigator setDestinations:@[waypoint1]
                     routingOptions:routingOptions
                           callback:^(GMSRouteStatus routeStatus){...}];