Administrar waypoints

En este documento, se describe cómo puedes administrar las preferencias de puntos de referencia para tu app con dos funciones:

• Preferencias de ruta según el lado de la ruta
• Escala

Establece la preferencia de enrutamiento del lado de la ruta

De forma predeterminada, el SDK de Navigation para iOS encuentra la ruta más rápida a un punto de referencia. Sin embargo, esto no garantiza que el usuario llegue al lado deseado de la ruta, por ejemplo, el lado de la ruta en el que espera el cliente de un conductor de viajes compartidos. La función Preferencia de ruta del lado de la ruta te permite asegurarte de que el vehículo llegue al lado correcto de la ruta.

Cómo funciona

Estableces la preferencia para llegar a un lado particular de la ruta cuando creas el punto de referencia para esa parada. Puedes especificar la preferencia de una de dos maneras.

Prefiero el mismo lado de la ruta

Proporcionas las coordenadas geográficas del punto de referencia y, luego, estableces una marca preferSameSideOfRoad que indica que prefieres llegar al mismo lado de la ruta que el punto de referencia, ajustado a la acera más cercana.

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

Punto clave: En algunas situaciones, cuando el punto de referencia se ajusta al costado de la ruta más cercana, es posible que esta no sea la correcta. Por ejemplo, podría ser una ruta que está a la vuelta de la esquina de un cliente que espera un viaje compartido. Para evitar que esto ocurra, puedes usar preferredSegmentHeading en lugar de preferSameSideOfRoad (consulta la siguiente sección para obtener más detalles).

Establece un rumbo de llegada

Proporcionas las coordenadas geográficas del punto de referencia y, luego, una dirección de llegada preferredSegmentHeading que coincida con la dirección del flujo de tráfico en el mismo lado de la ruta que el destino.

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

El SDK de Navigation elige el tramo de ruta más cercano al punto de referencia que tenga una dirección de carril que se alinee (dentro de +/- 55 grados) con el lado de la ruta en el que se encuentra el punto de referencia.

Establece la preferencia de parada

En ciertos lugares, no es posible que los usuarios se detengan de forma segura (por ejemplo, áreas elevadas, transbordadores, ubicaciones subterráneas y otras áreas de acceso limitado). La función Parada reubica el punto de referencia en un lugar cercano si su ubicación no es adecuada para que el usuario se detenga. Cuando estableces vehicleStopover en YES, el punto de referencia se reubica automáticamente cuando se calcula la ruta, si hay una ubicación alternativa disponible.

Cómo funciona

Estableces la preferencia para una parada cuando creas el punto de referencia de esa parada. Para ello, establece la preferencia de una parada en un GMSNavigationMutableWaypoint, como se muestra en el siguiente ejemplo:

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){...}];