Rotayı izleme

iOS için Navigasyon SDK'sını kullanarak uygulamanızda tek bir hedefe giden rota çizmek için bu kılavuzu inceleyin.

Genel Bakış

  1. Projenizi oluşturma bölümünde açıklandığı şekilde Navigation SDK'yı uygulamanıza entegre edin.
  2. GMSMapView yapılandırın.
  3. Kullanıcıdan hükümler ve koşulları kabul etmesini, konum hizmetleri ve arka plan bildirimleri için yetki vermesini isteyin.
  4. Bir veya daha fazla hedef içeren bir dizi oluşturun.
  5. Adım adım rotayı kontrol etmek için GMSNavigator tanımlayın.

Kodu göster

Kullanıcıdan gerekli yetkilendirmeleri isteyin.

Kullanıcı, Navigation SDK'yı kullanmadan önce hükümler ve koşulları kabul etmeli ve navigasyon için gerekli olan konum hizmetlerinin kullanımına izin vermelidir. Uygulamanız arka planda çalışacaksa kullanıcıdan rehberlik uyarısı bildirimlerini yetkilendirmesini de istemelidir. Bu bölümde, gerekli yetkilendirme istemlerinin nasıl gösterileceği açıklanmaktadır.

Konum hizmetlerini yetkilendirme

Navigation SDK, kullanıcı yetkilendirmesi gerektiren konum hizmetlerini kullanır. Konum hizmetlerini etkinleştirmek ve yetkilendirme iletişim kutusunu görüntülemek için aşağıdaki adımları uygulayın:

  1. Xcode'da konum ve arka plan özelliklerini etkinleştirin:

    1. Xcode'da hedefinizi açın ve Signing & Capabilities (İmzalama ve Özellikler) sekmesini seçin. Ayrıntılar için Apple'ın uygulamanıza özellik ekleme ile ilgili kılavuzuna bakın.
    2. Konum (Her Zaman) ve Konum (Kullanım Sırasında) özelliklerini ekleyin. Her birinin metin alanına, uygulamanızın neden konum hizmetlerine ihtiyaç duyduğuna dair kısa bir açıklama ekleyin (örneğin: "Bu uygulamanın, adım adım rota için konum hizmetlerini kullanma iznine ihtiyacı var.").
    3. Background Modes (Arka Plan Modları) özelliğini ekleyin ve ardından Location updates (Konum güncellemeleri) onay kutusunu işaretleyin. Bu özellik olmadan uygulama, navigasyon başlatılırken kilitlenir. Ayrıntılar için Apple'ın arka planda konum güncellemelerini işleme ile ilgili kılavuzuna bakın.
  2. Yetkilendirme iletişim kutusunu görüntülemek için konum yöneticisi örneğinin requestAlwaysAuthorization() yöntemini çağırın.

Swift

self.locationManager.requestAlwaysAuthorization()

Objective-C

[_locationManager requestAlwaysAuthorization];

Konum hizmeti yetkilendirmesiyle ilgili Apple belgelerinin tamamını inceleyin.

Arka planda rehberlik için uyarı bildirimlerine izin verme

Navigation SDK'nın, uygulama arka planda çalışırken uyarı bildirimleri gönderebilmesi için kullanıcı izni gerekir. Bu bildirimleri göstermek için kullanıcıdan izin istemek üzere aşağıdaki kodu ekleyin:

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

Hareket sensörlerini yetkilendirme

Gelecekteki önemli bir sürümde, iOS için Navigasyon SDK'sı, rota rakımını hesaplamak için temel konum verilerini cihaz hareket sensörleriyle (CMAltimeter) birleştirir. SDK, yükseklik ölçere eriştiğinde iOS, kullanıcıdan izin istemek için bu dizeyi otomatik olarak kullanır.

Bu anahtarı eklemenin mevcut davranış üzerinde herhangi bir etkisi yoktur ancak SDK'yı daha sonra yükselttiğinizde başlatma kilitlenmelerini önler.

SDK'nın gelecekteki yükseltmelerine hazırlanmak için hareket sensörü yetkilendirmelerini aşağıdaki gibi yapılandırın:

  1. Xcode'da hedefinizi açın ve Info (Bilgi) sekmesine gidin veya Info.plist dosyanızı açın.

  2. Yeni bir anahtar ekleyin: Privacy - Motion Usage Description (NSMotionUsageDescription).

  3. Kullanıcı için kısa bir açıklama ekleyin. Örneğin: "Bu uygulama, rakımı hesaplamak ve harita rotası doğruluğunu artırmak için hareket sensörü erişimi gerektirir."

Hükümler ve koşulları kabul etme

Hükümler ve koşullar iletişim kutusunu göstermek ve kullanıcı şartları kabul ettiğinde navigasyonu etkinleştirmek için aşağıdaki kodu kullanın. Bu örnekte, konum hizmetleri ve rehberlik uyarısı bildirimleri için kodun (daha önce gösterilen) yer aldığını unutmayın.

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

Rota oluşturma ve rehberliği başlatma

Rota çizmek için ziyaret edilecek bir veya daha fazla hedef içeren bir diziyle navigasyon aracının setDestinations yöntemini çağırın.GMSNavigationWaypoint Rota başarıyla hesaplanırsa haritada gösterilir. Rota boyunca rehberliği başlatmak için geri çağırmada isGuidanceActive değerini true olarak ayarlayın.

Aşağıdaki örnekte şunlar gösterilmektedir:

  • Tek varış noktası olan yeni bir rota oluşturuluyor.
  • Yönergeler başlatılıyor.
  • Arka plan rehberlik bildirimleri etkinleştiriliyor.
  • Rota boyunca seyahat simülasyonu yapma (isteğe bağlı).
  • Kamera modunu "takip et" olarak ayarlama (isteğe bağlı).

Swift

func startNav() {
  var destinations = [GMSNavigationWaypoint]()
  destinations.append(GMSNavigationWaypoint.init(placeID: "ChIJnUYTpNASkFQR_gSty5kyoUk",
                                                 title: "PCC Natural Market")!)

  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"]];

  [_mapView.navigator setDestinations:destinations
                             callback:^(GMSRouteStatus routeStatus){
                               [_mapView.locationSimulator simulateLocationsAlongExistingRoute];
                               _mapView.navigator.guidanceActive = YES;
                               _mapView.cameraMode = GMSNavigationCameraModeFollowing;
                             }];
}

Yer kimlikleri hakkında bilgi edinmek için Yer kimlikleri başlıklı makaleyi inceleyin.

Çok duraklı senaryolar

En fazla 25 yol noktası yapılandırabilirsiniz.

setDestinations yöntemi, birden fazla durak içeren yolculukları desteklemez. Yol noktasını yolculuğun bir sonraki ayağına ilerletmek için continueToNextDestinationWithCompletion() düğmesini kullanın.

Ulaşım şeklini ayarla

Seyahat modu, hem getirilecek rota türünü hem de kullanıcının rotasının nasıl belirleneceğini tanımlar. Bir rota için dört seyahat modundan birini ayarlayabilirsiniz: araba, bisiklet, yaya ve taksi. Sürüş ve taksi modunda kullanıcının rotası, seyahat yönüne göre belirlenir. Bisiklet ve yürüme modunda ise rota, cihazın baktığı yöne göre belirlenir (yatay modda cihazın üst kısmına doğru).

Harita görünümünün travelMode özelliğini aşağıdaki örnekte gösterildiği gibi ayarlayın:

Swift

self.mapView.travelMode = .cycling

Objective-C

_mapView.travelMode = GMSNavigationTravelModeCycling;

Kaçınılacak yolları ayarlama

Bir rota boyunca otoyollardan, paralı yollardan veya her ikisinden de kaçınmak için avoidsHighways ve avoidsTolls BOOL özelliklerini kullanın.

Swift

self.mapView.navigator?.avoidsTolls = true

Objective-C

_mapView.navigator.avoidsTolls = YES;

Sesli rehberlik ses seviyesini ayarlama

Sesli yardımın ses düzeyini ayarlamak için navigasyon cihazındaki volumeLevel özelliğini düşük, normal veya yüksek olarak ayarlayın. Navigasyon, son kaydedilen ses seviyesini kullanır veya varsayılan olarak normal seviyeye ayarlanır.

Swift

self.mapView.navigator?.volumeLevel = .low

Objective-C

_mapView.navigator.volumeLevel = GMSNavigationVolumeLevelLow;

Yer kimliği bulma aracı

Rota varış noktaları için kullanılacak yer kimliklerini bulmak üzere PlaceID Finder'ı kullanabilirsiniz. GMSNavigationWaypoint ile placeID üzerinden hedef ekleyin.

Kayan metin

Google ilişkilendirmesi kapatılmadığı sürece uygulamanızın herhangi bir yerine kayan metin ekleyebilirsiniz. Navigation SDK, metnin haritadaki belirli koordinatlara (enlem, boylam) veya bir etikete sabitlenmesini desteklemez. Daha fazla bilgi için Bilgi pencereleri başlıklı makaleyi inceleyin.