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 ayarlama 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ı, Navigasyon SDK'sını 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'sı, 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ımdayken) ö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 olmadığında 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. Kullanıcıdan bu bildirimleri gösterme izni istemek için 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
iOS için Navigasyon SDK'sı, gelecekteki önemli bir sürümde rota rakımını hesaplamak için temel konum verilerini cihaz hareket sensörleriyle (CMAltimeter) birleştirecek. 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 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 GMSNavigationWaypoint hedefinden oluşan bir diziyle navigasyon aracının setDestinations yöntemini çağırın. Rota başarıyla hesaplanırsa haritada görünür. 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 planda rehberlik bildirimleri etkinleştiriliyor.
- Rota boyunca seyahat simülasyonu (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.
Birden fazla durak içeren senaryolar
En fazla 25 yol noktası yapılandırabilirsiniz.
Navigation SDK, bir sonraki hedefe otomatik olarak ilerlemez. Araç bir ara noktaya ulaştığında gezinin bir sonraki ayağını başlatmak için continueToNextDestinationWithCompletion: yöntemini çağırın. Bu durum, ara noktaları olan rota jetonları için de geçerlidir. Bir sonraki hedefe ilerlediğinizde Navigasyon SDK'sı, yeni bir rota planlamak yerine rota jetonunuzdaki rotayı takip etmeye devam eder.
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 otoyolları, paralı yolları veya her ikisini de kullanmamak 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 bulucu
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, metni haritadaki belirli koordinatlara (enlem, boylam) veya bir etikete sabitlemeyi desteklemez. Daha fazla bilgi için Bilgi pencereleri başlıklı makaleyi inceleyin.