Z tego przewodnika dowiesz się, jak wyznaczyć w aplikacji trasę do jednego miejsca docelowego za pomocą pakietu Navigation SDK na iOS.
Przegląd
- Zintegruj pakiet Navigation SDK z aplikacją zgodnie z opisem w sekcji Konfigurowanie projektu.
- Skonfiguruj GMSMapView.
- Poproś użytkownika o zaakceptowanie warunków i zezwolenie na usługi lokalizacyjne oraz powiadomienia w tle.
- Utwórz tablicę zawierającą co najmniej 1 miejsce docelowe.
- Określ - GMSNavigator, aby sterować nawigacją zakręt po zakręcie.- Dodaj miejsca docelowe za pomocą ikony setDestinations.
- Ustaw isGuidanceActivenatrue, aby rozpocząć nawigację.
- Użyj simulateLocationsAlongExistingRoute, aby symulować postęp pojazdu na trasie na potrzeby testowania, debugowania i demonstrowania aplikacji.
 
- Dodaj miejsca docelowe za pomocą ikony 
Wyświetl kod
Prośba użytkownika o niezbędne autoryzacje
Przed użyciem pakietu Navigation SDK użytkownik musi zaakceptować warunki korzystania z usługi i zezwolić na korzystanie z usług lokalizacyjnych, które są wymagane do nawigacji. Jeśli aplikacja będzie działać w tle, musi też wyświetlać prośbę o zezwolenie na powiadomienia z alertami dotyczącymi wskazówek. W tej sekcji znajdziesz informacje o tym, jak wyświetlać wymagane prośby o autoryzację.
Autoryzowanie usług lokalizacyjnych
Pakiet Navigation SDK korzysta z usług lokalizacyjnych, które wymagają autoryzacji użytkownika. Aby włączyć usługi lokalizacyjne i wyświetlić okno dialogowe autoryzacji, wykonaj te czynności:
- Dodaj klucz NSLocationAlwaysUsageDescriptiondo urządzeniaInfo.plist.
- W przypadku wartości dodaj krótkie wyjaśnienie, dlaczego Twoja aplikacja wymaga usług lokalizacyjnych. Przykład: „Ta aplikacja potrzebuje uprawnień do korzystania z usług lokalizacyjnych w celu nawigacji krok po kroku”. 
- Aby wyświetlić okno autoryzacji, wywołaj - requestAlwaysAuthorization()instancji menedżera lokalizacji.
Swift
self.locationManager.requestAlwaysAuthorization()
Objective-C
[_locationManager requestAlwaysAuthorization];
Autoryzowanie powiadomień o alertach w celu uzyskiwania wskazówek w tle
Pakiet Navigation SDK potrzebuje zgody użytkownika na wyświetlanie alertów, gdy aplikacja działa w tle. Dodaj ten kod, aby poprosić użytkownika o zezwolenie na wyświetlanie tych powiadomień:
Swift
UNUserNotificationCenter.current().requestAuthorization(options: [.alert]) {
  granted, error in
    // Handle denied authorization to display notifications.
    if !granted || error != nil {
      print("User rejected request to display notifications.")
    }
}
Objective-C
// Request authorization for alert notifications.
UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
UNAuthorizationOptions options = UNAuthorizationOptionAlert;
[center requestAuthorizationWithOptions:options
                      completionHandler:
 ^(
   BOOL granted,
   NSError *_Nullable error) {
     if (!error && granted) {
       NSLog(@"iOS Notification Permission: newly Granted");
     } else {
       NSLog(@"iOS Notification Permission: Failed or Denied");
     }
   }];
Zaakceptuj warunki korzystania z usługi
Użyj tego kodu, aby wyświetlić okno z warunkami i umożliwić nawigację, gdy użytkownik zaakceptuje warunki. Pamiętaj, że ten przykład zawiera kod usług lokalizacyjnych i powiadomień o alertach (pokazany wcześniej).
Swift
  let termsAndConditionsOptions = GMSNavigationTermsAndConditionsOptions(companyName: "Ride Sharing Co.")
  GMSNavigationServices.showTermsAndConditionsDialogIfNeeded(
    with: termsAndConditionsOptions) { termsAccepted in
    if termsAccepted {
      // Enable navigation if the user accepts the terms.
      self.mapView.isNavigationEnabled = true
      self.mapView.settings.compassButton = true
      // Request authorization to use location services.
      self.locationManager.requestAlwaysAuthorization()
      // Request authorization for alert notifications which deliver guidance instructions
      // in the background.
    UNUserNotificationCenter.current().requestAuthorization(options: [.alert]) {
      granted, error in
        // Handle rejection of notification authorization.
        if !granted || error != nil {
          print("Authorization to deliver notifications was rejected.")
        }
      }
    } else {
      // Handle rejection of terms and conditions.
    }
  }
Objective-C
GMSNavigationTermsAndConditionsOptions *termsAndConditionsOptions = [[GMSNavigationTermsAndConditionsOptions alloc] initWithCompanyName:@"Ride Sharing Co."];
[GMSNavigationServices
  showTermsAndConditionsDialogIfNeededWithOptions:termsAndConditionsOptions
  callback:^(BOOL termsAccepted) {
   if (termsAccepted) {
     // Enable navigation if the user accepts the terms.
     _mapView.navigationEnabled = YES;
     _mapView.settings.compassButton = YES;
     // Request authorization to use the current device location.
     [_locationManager requestAlwaysAuthorization];
     // Request authorization for alert notifications which deliver guidance instructions
     // in the background.
     UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
     UNAuthorizationOptions options = UNAuthorizationOptionAlert;
     [center requestAuthorizationWithOptions:options
                           completionHandler:
     ^(
       BOOL granted,
       NSError *_Nullable error) {
         if (!error && granted) {
           NSLog(@"iOS Notification Permission: newly Granted");
         } else {
           NSLog(@"iOS Notification Permission: Failed or Denied");
         }
       }];
   } else {
     // Handle rejection of the terms and conditions.
   }
 }];
Tworzenie trasy i rozpoczynanie nawigacji
Aby wyznaczyć trasę, wywołaj metodę setDestinations() klasy Navigator z tablicą zawierającą co najmniej 1 miejsce docelowe (GMSNavigationWaypoint). Jeśli trasa zostanie obliczona, pojawi się na mapie. Aby rozpocząć nawigację po trasie, zaczynając od pierwszego miejsca docelowego, ustaw w wywołaniu zwrotnym wartość isGuidanceActive na true.
Poniższy przykład pokazuje:
- Tworzenie nowej trasy z 2 miejscami docelowymi.
- Rozpoczynam nawigację.
- Włączanie powiadomień z instrukcjami w tle.
- Symulowanie podróży wzdłuż trasy (opcjonalnie).
- Ustawienie trybu kamery na „śledzenie” (opcjonalnie).
Swift
func startNav() {
  var destinations = [GMSNavigationWaypoint]()
  destinations.append(GMSNavigationWaypoint.init(placeID: "ChIJnUYTpNASkFQR_gSty5kyoUk",
                                                 title: "PCC Natural Market")!)
  destinations.append(GMSNavigationWaypoint.init(placeID:"ChIJJ326ROcSkFQRBfUzOL2DSbo",
                                                 title:"Marina Park")!)
  mapView.navigator?.setDestinations(destinations) { routeStatus in
    self.mapView.navigator?.isGuidanceActive = true
    self.mapView.locationSimulator?.simulateLocationsAlongExistingRoute()
    self.mapView.cameraMode = .following
  }
}
Objective-C
- (void)startNav {
  NSArray<GMSNavigationWaypoint *> *destinations =
  @[[[GMSNavigationWaypoint alloc] initWithPlaceID:@"ChIJnUYTpNASkFQR_gSty5kyoUk"
                                             title:@"PCC Natural Market"],
    [[GMSNavigationWaypoint alloc] initWithPlaceID:@"ChIJJ326ROcSkFQRBfUzOL2DSbo"
                                             title:@"Marina Park"]];
  [_mapView.navigator setDestinations:destinations
                             callback:^(GMSRouteStatus routeStatus){
                               [_mapView.locationSimulator simulateLocationsAlongExistingRoute];
                               _mapView.navigator.guidanceActive = YES;
                               _mapView.cameraMode = GMSNavigationCameraModeFollowing;
                             }];
}
Więcej informacji o identyfikatorach miejsc znajdziesz w artykule Identyfikatory miejsc.
Scenariusze z wieloma przystankami
Metoda setDestinations nie obsługuje podróży z wieloma przystankami. Użyj continueToNextDestination(), aby przejść do następnego etapu podróży.
Wybierz środek transportu
Tryb podróży określa, jaki typ trasy zostanie pobrany i w jaki sposób zostanie wyznaczony kurs użytkownika. Dla trasy możesz ustawić jeden z 4 rodzajów transportu: samochód, rower, pieszo i taksówka. W trybie jazdy samochodem i taksówką kurs użytkownika jest określany na podstawie kierunku podróży, a w trybie jazdy na rowerze i chodzenia – na podstawie kierunku, w którym jest zwrócone urządzenie (w trybie poziomym – w górę urządzenia).
Ustaw właściwość travelMode widoku mapy, jak pokazano w tym przykładzie:
Swift
self.mapView.travelMode = .cycling
Objective-C
_mapView.travelMode = GMSNavigationTravelModeCycling;
Ustawianie dróg, których chcesz unikać
Użyj właściwości avoidsHighways i avoidsTolls BOOL, aby omijać autostrady lub drogi płatne na trasie.
Swift
self.mapView.navigator?.avoidsTolls = true
Objective-C
_mapView.navigator.avoidsTolls = YES;
Wyszukiwarka identyfikatorów miejsc
Aby znaleźć identyfikatory miejsc, które możesz wykorzystać jako miejsca docelowe na trasie, użyj wyszukiwarki identyfikatorów miejsc. Dodaj miejsce docelowe z placeID za pomocą GMSNavigationWaypoint.
Pływający tekst
Pływający tekst możesz dodać w dowolnym miejscu w aplikacji, o ile nie zasłania on informacji o atrybucji Google. Pakiet Navigation SDK nie obsługuje przypisywania tekstu do współrzędnych geograficznych na mapie ani do etykiety. Więcej informacji znajdziesz w sekcji Okna informacji.