iOS için Navigasyon SDK'sını kullanarak uygulamanızda tek bir hedefe giden rota çizmek için bu kılavuzu inceleyin.
Genel Bakış
- Projenizi oluşturma bölümünde açıklandığı şekilde Navigation SDK'yı uygulamanıza entegre edin.
GMSMapViewyapılandırın.- Kullanıcıdan hükümler ve koşulları kabul etmesini, konum hizmetleri ve arka plan bildirimleri için yetki vermesini isteyin.
- Bir veya daha fazla hedef içeren bir dizi oluşturun.
Adım adım rotayı kontrol etmek için
GMSNavigatortanımlayın.setDestinationskullanarak hedef ekleyin.- Navigasyonu başlatmak için
isGuidanceActivedeğerinitrueolarak ayarlayın. - Uygulamanızı test etmek, hatalarını ayıklamak ve göstermek için aracın rota boyunca ilerlemesini simüle etmek üzere
simulateLocationsAlongExistingRoutekullanı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:
Xcode'da konum ve arka plan özelliklerini etkinleştirin:
- 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.
- 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.").
- 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.
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:
Xcode'da hedefinizi açın ve Info (Bilgi) sekmesine gidin veya
Info.plistdosyanızı açın.Yeni bir anahtar ekleyin: Privacy - Motion Usage Description (
NSMotionUsageDescription).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.