Mengelola titik jalan

Dokumen ini menjelaskan cara mengelola preferensi titik jalan untuk aplikasi Anda menggunakan dua fitur:

  • Preferensi pemilihan rute sisi jalan
  • Transit

Menetapkan preferensi pemilihan rute sisi jalan

Secara default, Navigation SDK for iOS menemukan rute tercepat ke titik jalan, tetapi hal ini tidak menjamin bahwa pengguna akan tiba di sisi jalan yang diinginkan, misalnya, sisi jalan tempat pelanggan pengemudi transportasi online menunggu. Fitur Preferensi Pemilihan Rute Sisi Jalan memungkinkan Anda memastikan bahwa kendaraan tiba di sisi jalan yang benar.

Cara kerjanya

Anda menetapkan preferensi untuk tiba di sisi jalan tertentu saat membuat titik jalan untuk perhentian tersebut. Anda dapat menentukan preferensi dengan salah satu dari dua cara.

Lebih memilih sisi jalan yang sama

Anda memberikan koordinat geografis titik jalan, lalu menetapkan flag preferSameSideOfRoad yang menunjukkan bahwa Anda lebih memilih untuk tiba di sisi jalan yang sama dengan titik jalan—disesuaikan dengan trotoar terdekat.

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

Menetapkan arah kedatangan

Anda memberikan koordinat geografis titik jalan, lalu memberikan arah kedatangan preferredSegmentHeading yang sesuai dengan arah arus lalu lintas di sisi jalan yang sama dengan tujuan.

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

Navigation SDK memilih segmen jalan yang paling dekat dengan titik jalan—yang memiliki arah lajur yang sejajar (dalam +/- 55 derajat) dengan sisi jalan tempat titik jalan berada.

Menetapkan preferensi transit

Di tempat tertentu, pengguna tidak dapat berhenti dengan aman (misalnya, area yang ditinggikan, feri, lokasi bawah tanah, dan area lain dengan akses terbatas). Fitur Transit memindahkan titik jalan ke tempat terdekat jika lokasinya tidak cocok untuk pengguna berhenti. Saat Anda menetapkan vehicleStopover ke YES, titik jalan akan otomatis dipindahkan saat rute dihitung, jika lokasi alternatif tersedia.

Cara kerjanya

Anda dapat menetapkan preferensi untuk perhentian saat membuat titik jalan untuk perhentian tersebut. Untuk melakukannya, tetapkan preferensi untuk transit di GMSNavigationMutableWaypoint seperti yang ditunjukkan dalam contoh berikut:

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