Adım adım veri feed'i, harita tabanlı navigasyon yardımı için tasarlanmamış cihazlara yalnızca navigasyon bilgileri sağlar. Gelecek manevralara sağladığınız öğeler ile sağlanıyor:
- simgeler (sola, sağa, U dönüşü)
- Döner kavşaklarda numaraları çevir
- yol adları
- bir sonraki navigasyon adımına veya nihai hedefe kalan tahmini mesafe ve süre
Küçük ekran görüntüleri gibi tüm gezinme SDK'sı kullanıcı arayüzünün uygun olmadığı deneyimler oluşturmak için adım adım feed'i kullanabilirsiniz. Örneğin, iki tekerlekli araç kullanıcıları için bu özellikten yararlanarak yalnızca navigasyon odaklı rehberlik projesini, dikkat dağıtıcı unsurlarla varış noktasına daha hızlı ve güvenle ulaşmasına yardımcı olabilirsiniz.
Temel gezinme görüntülü öğeleri
Her navigasyon adımıyla ilgili birincil alanlar, GMSNavigationStepInfo adresinde bulunan tam yol adı, manevra ve adımın toplam mesafesidir.
Genel seyahat için, kalan süreyi ve geçerli adıma veya hedefe olan mesafeyi görüntülemek isteyebilirsiniz. Bunların tümü GMSNavigationNavInfo'da mevcuttur. Sağ taraftaki resimde, bu önemli gezinme öğelerinin bir örneği gösterilmektedir.
Etkinlik işleyici ayarlama
Yalnızca gezinme verilerini kullanmak istiyorsanız didChangeNavInfo
etkinliği için bir etkinlik işleyici uygulamanız gerekir. Kullanıcılarınıza adım adım navigasyon sağlamak için etkinlik işleyicide gezi ve adım bilgilerine erişin.
Etkinlik işleyicileri uygulamak için haritanın görüntüleme denetleyicisinin GMSNavigatorListener
protokolünü uygulaması gerekir. iOS için Navigasyon SDK'sındaki etkinlikleri işleme hakkında ayrıntılı bilgi için Gezinme etkinliklerini dinleme konusuna bakın.
didChangeNavInfo
etkinliğini işleme
Uygulamanıza adım adım destek eklemek için didChangeNavInfo
etkinliği için bir işleyici oluşturun. Etkinlik işleyicide adım adım navigasyonu kontrol etmek için aşağıdaki sınıfları ve numaralandırmaları kullanın:
GMSNavigationNavInfo
— Gezinme durumuyla ilgili sınıf tanımlayıcı bilgiler.GMSNavigationStepInfo
— Bir navigasyon rotasındaki tek bir adımla ilgili bilgileri tanımlayan sınıf.GMSNavigationNavState
— Bir navigasyonun geçerli durumunu (ör. yol tarifi, yeni rota oluşturma veya durduruldu) tanımlayan sıralama.GMSNavigationDrivingSide
— Bu adımın sağdan araçla mı yoksa soldan sürüşlü bir rotada mı olduğunu tanımlayan sıralama.GMSNavigationManeuver
— Sola dönme veya sağa dönme gibi, yapılacak gezinme işlemini tanımlayan sıralama.
Aşağıda, didChangeNavInfo
etkinliği için örnek etkinlik işleyiciler gösterilmektedir:
Objective-C
// ViewController.h @interface SomeViewController () <GMSNavigatorListener> @end // ViewController.m @implementation SomeViewController // Some initialization code. ... { ... [_mapView.navigator addListener:self]; ... } #pragma mark GMSNavigatorListener - (void)navigator:(GMSNavigator *)navigator didUpdateNavInfo:(GMSNavigationNavInfo *)navInfo { // Get the current step information if (navInfo.navState == GMSNavigationNavStateEnroute) { GMSNavigationStepInfo *currentStep = navInfo.currentStep; if (currentStep) { ... roadNameLabel.text = currentStep.simpleRoadName; ... } } ... }
Swift
// ViewController.swift class SomeViewController: UIViewController { ... mapView.navigator?.add(self); ... } extension SomeViewController: GMSNavigatorListener { func navigator(_ navigator: GMSNavigator, didUpdateNavInfo navInfo: GMSNavigationNavInfo) { // Get the current step information if navInfo.navState == .enroute { if let currentStep = navInfo.currentStep { ... roadNameLabel.text = currentStep.simpleRoadName ... } } } }
Navigasyon durumları
Mevcut gezinme durumunu öğrenmek için GMSNavigationNavInfo
öğesinin navState
özelliğini kullanın. Bu durum aşağıdakilerden biri olabilir:
Yolda:
GMSNavigationNavStateEnroute
durumu, rehberli navigasyonun şu anda etkin olduğu ve kullanıcının belirtilen rotada olduğu anlamına gelir. Yaklaşan manevra adımıyla ilgili bilgi mevcut.Yeni rota belirleniyor -
GMSNavigationNavStateRerouting
, navigasyonun devam ettiği, ancak navigasyonun yeni bir rota aradığı anlamına gelir. Henüz yeni bir rota olmadığından yaklaşan manevra adımı kullanılamıyor.Durduruldu:
GMSNavigationNavStateStopped
gezinmenin sona erdiği anlamına gelir. Örneğin, kullanıcı uygulamada gezinmeden çıktığında gezinme durur. Örnek uygulamadaGMSNavigationNavStateStopped
durumu, geciken adım talimatlarının görüntülenmesini önlemek için gezinme bilgileri ekranını temizler.
Şerit yardımı
Gezinme SDK'sı, navigasyon dönüş kartındaki şeritleri GMSNavigationLane
ve GMSNavigationLaneDirection
veri nesneleri olarak gösterir. GMSNavigationLane
nesnesi, navigasyon sırasında belirli bir şeridi temsil eder ve bu şeritten yapılabilecek tüm dönüşleri açıklayan GMSNavigationLaneDirection
nesnelerin listesini içerir.
Sürücünün bir şeritte izlemesi gereken önerilen yön, recommended
alanı kullanılarak işaretlenir.
Şerit yardımı örneği
Aşağıdaki snippet, önceki ekran görüntüsünde bulunan şeritlerin veri temsilini göstermektedir.
// Lane 1
GMSNavigationLaneDirections =
[{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]
// Lane 2
GMSNavigationLaneDirections =
[{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]
// Lane 3
GMSNavigationLaneDirections =
[{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false}]
// Lane 4
GMSNavigationLaneDirections =
[{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false},
{/*GMSNavigationLaneShape=*/ GMSNavigationLaneShapeNormalRight, /*recommended=*/ false}]
Şerit yardımı resimleri
Navigasyon SDK'sı, GMSNavigationStepInfo
tarafından iletildiği şekliyle her bir navigasyon adımı için şerit görüntüleri oluşturmayı destekler. Bu simgeler CarPlay'in resim boyutlandırma kılavuzuna uyar.
Swift
let currentStepInfo = navInfo.currentStep let options = GMSNavigationStepImageOptions() options.maneuverImageSize = .square96 options.screenMetrics = UIScreen.mainScreen let maneuverImage = currentStepinfo.maneuverImage(options: options)
Objective-C
GMSNavigationStepInfo *stepInfo = navInfo.currentStep; GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init]; options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96; options.screenMetrics = UIScreen.mainScreen; UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];
Manevralar için simgeler oluşturma
GMSNavigationManeuver
sıralaması, gezinirken gerçekleşebilecek her bir olası manevrayı tanımlar ve belirli bir adım için manevrayı GMSNavigationStepInfo
öğesinin maneuver
özelliğinden alabilirsiniz.
Manevra simgeleri oluşturmalı ve bunları ilişkili manevralarıyla eşleştirmelisiniz.
Bazı manevralarda,
GMSNavigationManeuverDestinationLeft
ve
GMSNavigationManeuverDestinationRight
gibi bir simgeyle bire bir eşleme ayarlayabilirsiniz. Ancak, bazı manevralar diğer manevralarla aynı özellikleri paylaştığından, tek bir simgeye birden fazla manevra eşlemek isteyebilirsiniz. Örneğin, hem GMSNavigationManeuverTurnLeft
hem de GMSNavigationManeuverOnRampLeft
, sola dön simgesiyle eşlenebilir.
Bazı manevralar, SDK'nın bir ülkenin sürüş şekline göre belirlediği ek bir "Saat Yönü" veya "Saat Yönünde" etiketi içerir. Örneğin, sürüşün yolun sol tarafında olduğu ülkelerde, sürücüler saat yönünde bir döner kavşakta veya U dönüşü kullanırken yolun sağ tarafındaki ülkeler saat yönünün tersine gider. Gezinme SDK'sı, bir manevranın sol veya sağ taraftaki trafikte mi gerçekleştiğini algılar ve uygun manevrayı verir. Bu nedenle, manevra simgeniz saat yönünde ve saat yönünün tersine davranış için farklı olabilir.
Farklı manevralara ilişkin örnek simgeleri görmek için genişletin
Örnek Simge | Adım Adım Manevralar |
---|---|
![]() |
DEPART UNKNOWN |
![]() |
STRAIGHT ON_RAMP_UNSPECIFIED OFF_RAMP_UNSPECIFIED NAME_CHANGE
|
![]() |
TURN_RIGHT ON_RAMP_RIGHT
|
![]() |
TURN_LEFT ON_RAMP_LEFT
|
![]() |
TURN_SLIGHT_RIGHT ON_RAMP_SLIGHT_RIGHT OFF_RAMP_SLIGHT_RIGHT
|
![]() |
TURN_SLIGHT_LEFT ON_RAMP_SLIGHT_LEFT OFF_RAMP_SLIGHT_LEFT
|
![]() |
TURN_SHARP_RIGHT ON_RAMP_SHARP_RIGHT OFF_RAMP_SHARP_RIGHT
|
![]() |
TURN_SHARP_LEFT ON_RAMP_SHARP_LEFT OFF_RAMP_SHARP_LEFT
|
![]() |
TURN_U_TURN_COUNTERCLOCKWISE ON_RAMP_U_TURN_COUNTERCLOCKWISE OFF_RAMP_U_TURN_COUNTERCLOCKWISE
|
![]() |
TURN_U_TURN_CLOCKWISE ON_RAMP_U_TURN_CLOCKWISE OFF_RAMP_U_TURN_CLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_RIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_RIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_RIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_RIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_RIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_RIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_STRAIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_STRAIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_LEFT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_LEFT_CLOCKWISE
|
![]() |
ROUNDABOUT_LEFT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_LEFT_CLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_LEFT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_LEFT_CLOCKWISE
|
![]() |
ROUNDABOUT_U_TURN_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_U_TURN_CLOCKWISE
|
![]() |
ROUNDABOUT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_CLOCKWISE
|
![]() |
ROUNDABOUT_EXIT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_EXIT_CLOCKWISE
|
![]() |
MERGE_RIGHT OFF_RAMP_RIGHT
|
![]() |
MERGE_LEFT OFF_RAMP_LEFT
|
![]() |
FORK_RIGHT TURN_KEEP_RIGHT ON_RAMP_KEEP_RIGHT OFF_RAMP_KEEP_RIGHT
|
![]() |
FORK_LEFT TURN_KEEP_LEFT ON_RAMP_KEEP_LEFT OFF_RAMP_KEEP_LEFT
|
![]() |
MERGE_UNSPECIFIED
|
![]() |
DESTINATION
|
![]() |
DESTINATION_RIGHT
|
![]() |
DESTINATION_LEFT
|
![]() |
FERRY_BOAT
|
![]() |
FERRY_TRAIN
|
Oluşturulan simgeleri kullan
Gezinme SDK'sı, belirli bir GMSNavigationStepInfo
için manevra simgelerinin oluşturulmasını destekler. Bu simgeler CarPlay resim boyutlandırma kılavuzuna uyar.
Swift
let currentStepInfo = navInfo.currentStep let options = GMSNavigationStepImageOptions() options.maneuverImageSize = .square96 options.screenMetrics = UIScreen.mainScreen let maneuverImage = currentStepinfo.maneuverImage(options: options)
Objective-C
GMSNavigationStepInfo *stepInfo = navInfo.currentStep; GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init]; options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96; options.screenMetrics = UIScreen.mainScreen; UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];