Adım adım veri feed'ini etkinleştir

Adım adım veri feed'i, harita tabanlı navigasyon yardımı için tasarlanmamış cihazlara yalnızca navigasyon bilgileri sağlar. Sağladığınız öğelerle yaklaşan manevraları gösterir:

  • simgeler (sol, sağ, U dönüşü)
  • döner kavşaklarda dönüş numaraları
  • yol adları
  • Bir sonraki navigasyon adımına veya nihai hedefe olan tahmini mesafe ve süre

Adım adım feed'i kullanarak, Android Auto veya tam Android yığınının kullanılamadığı küçük ekranlar gibi tam Navigasyon SDK'sı kullanıcı arayüzünün uygun olmadığı deneyimler oluşturabilirsiniz. Örneğin, bu özelliği iki tekerlekli araç sürücüleri için kullanabilirsiniz. Bu sürücülere yalnızca navigasyon rehberliği sunarak dikkatlerini dağıtmadan, daha hızlı ve daha güvenli bir şekilde hedeflerine ulaşmalarına yardımcı olabilirsiniz.

SDK'yı kullanmak için bir hizmet oluşturup bu hizmeti Android için Navigasyon SDK'sına kaydetmeniz gerekir. Böylece hizmet, yeni navigasyon bilgilerini anlık olarak (navigasyon sırasında yaklaşık saniyede bir) alabilir.

Bu belgede, SDK'dan navigasyon bilgilerini alan ve navigasyon durumunu alıcı cihaza sağlayan bir navigasyon hizmetinin nasıl oluşturulacağı ve kaydedileceği gösterilmektedir.

Genel Bakış

Bu bölümde, adım adım özelliği etkinleştirmeyle ilgili üst düzey akış özetlenmektedir.

Adım adım özelliği kullanımı

Adım adım özelliği etkinleştirmek için aşağıdaki genel adımları uygulayın. Aşağıdaki bölümlerde her adımla ilgili ayrıntılı bilgi verilmektedir.

  1. Navigasyon güncellemelerini almak için bir hizmet oluşturun.

  2. Hizmeti kaydetme

  3. Navigasyon durumlarını anlama

Navigasyon güncellemelerini almak için hizmet oluşturma

Navigasyon SDK'sı, TurnByTurn hizmetinize bağlanır ve Android Messenger aracılığıyla navigasyon güncellemelerini gönderir. Bu güncellemeler için yeni bir navigasyon hizmeti oluşturabilir veya mevcut bir hizmeti kullanabilirsiniz.

Navigasyon güncellemelerini almak için bir hizmet kullanmanın avantajı, hizmetin ayrı bir arka plan işleminde çalışabilmesidir.

Aşağıdaki örnekte yer alan hizmet, navigasyon bilgilerini alır ve verileri navigasyon ayrıntılarını içeren bir NavInfo nesnesine dönüştürmek için TurnByTurnManager kullanır.

/**
 *   Receives turn-by-turn navigation information forwarded from NavSDK.
 */
public class NavInfoReceivingService extends Service {
  /** The messenger used by the service to receive nav step updates. */
  private Messenger incomingMessenger;
  private TurnByTurnManager turnByTurnManager;

  private final class IncomingNavStepHandler extends Handler {
    public IncomingNavStepHandler(Looper looper) {
      super(looper);
    }

    @Override
    public void handleMessage(Message msg) {
      // Identify the message through the msg.what field.
      if (TurnByTurnManager.MSG_NAV_INFO == msg.what) {
        // Extract the NavInfo object using the TurnByTurnManager.
        NavInfo navInfo = turnByTurnManager
          .readNavInfoFromBundle(msg.getData()));
      // Do something with the NavInfo
    }
  }
}

@Nullable
@Override
public IBinder onBind(Intent intent) {
  return incomingMessenger.getBinder();
}

@Override
public void onCreate() {
  turnByTurnManager = TurnByTurnManager.createInstance();
  HandlerThread thread =
    new HandlerThread("NavInfoReceivingService",
      Process.THREAD_PRIORITY_DEFAULT);
  thread.start();
  incomingMessenger = new Messenger(
    new IncomingNavStepHandler(thread.getLooper()));
}

Mesaj kodları

NavInfo mesajları, Message sınıfının Message.what alanı üzerinden tanımlanabilir. Bu alan, TurnByTurnManager.MSG_NAV_INFO değerine ayarlanır.

Hizmet, navigasyon güncellemeleri için kaydediliyor

Aşağıdaki kod snippet'leri, navigasyon hizmetini kaydeder.

boolean isNavInfoReceivingServiceRegistered =
          navigator.registerServiceForNavUpdates(
              getPackageName(), NavInfoReceivingService.class.getName(), numNextStepsToPreview);

Hizmeti başlatma ve durdurma

Navigasyon hizmeti, Navigasyon SDK'sı bu hizmete bağlı olduğu sürece etkindir. Navigasyon hizmetinin yaşam döngüsünü kontrol etmek için startService() ve stopService() yöntemlerini manuel olarak çağırabilirsiniz. Ancak hizmetinizi Navigasyon SDK'sına kaydettiğinizde hizmetiniz otomatik olarak başlar ve yalnızca kaydını iptal ettiğinizde durur. Uygulamanızı nasıl ayarladığınıza bağlı olarak, Android belgelerindeki Hizmetlere genel bakış bölümünde açıklanan bir ön plan hizmeti başlatmayı düşünebilirsiniz.

Hizmetin kaydını iptal etme

Navigasyon güncellemelerini almayı durdurmak için hizmetin kaydını Navigation SDK'dan kaldırın.

navigator.unregisterServiceForNavUpdates();

Navigasyon durumlarını anlama

Navigasyonun mevcut durumunu öğrenmek için NavInfo.getNavState() yöntemini kullanın. Durum, aşağıdakilerden biri olabilir:

  • Yolda: ENROUTE durumu, rehberli navigasyonun etkin olduğu ve kullanıcının sağlanan rotada olduğu anlamına gelir. Mevcut ve yaklaşan manevra adımıyla ilgili bilgiler mevcuttur.

  • Yeni rota çiziliyor (REROUTING), navigasyonun devam ettiğini ancak navigasyon cihazının yeni bir rota aradığını gösterir. Henüz yeni bir rota olmadığı için yaklaşan manevra adımı kullanılamıyor. Örnek uygulamada, navigasyon bilgileri ekranında "Yeni rota çiziliyor..." mesajı gösterilir. Rota bulunduğunda ENROUTE durumuyla bir NavInfo mesajı gönderilir.

  • Durduruldu - STOPPED, navigasyonun sona erdiğini gösterir. Örneğin, kullanıcı uygulamada navigasyondan çıktığında navigasyon durur. Örnek uygulamada, STOPPED durumu, navigasyon bilgileri ekranını temizleyerek kalan adım talimatlarının gösterilmesini engeller.

Feed ekranını doldurma

Adım adım hizmetinizi ayarladığınıza göre, bu bölümde adım adım feed için kılavuz kartlarını doldurmak üzere kullanabileceğiniz görsel ve metin öğeleri ele alınmaktadır.

Mobil ekranda, 30 metre sonra W Ahwanee Ave yönünde sola dönüş gösteriliyor. Ekranın alt kısmında, hedefe kalan süre 46 dakika ve kalan mesafe 62 kilometre olarak gösteriliyor.

Kullanıcı, rehberli navigasyona girdiğinde üstte, Navigation SDK'dan doldurulan navigasyon verilerini içeren bir navigasyon kartı görünür. İlgili resimde bu temel gezinme öğelerinin bir örneği gösterilmektedir.

Bu tabloda, navigasyon bilgileriyle ilgili alanlar ve bu alanları nerede bulabileceğiniz gösterilmektedir.

Her bir navigasyon adımı için alanlar Tüm geziyle ilgili alanlar
StepInfo içinde bulundu NavInfo içinde bulundu
Yolun tam adı Kalan süre
Manevra simgesi Hedefe olan mesafe
Sonraki adıma olan mesafe
Şerit yardımı alanları

Şerit yardımı

Navigation SDK, navigasyon dönüş kartındaki şeritleri Lane ve LaneDirection veri nesneleri olarak temsil eder. Lane nesnesi, navigasyon sırasında belirli bir şeridi temsil eder ve bu şeritten yapılabilecek tüm dönüşleri açıklayan LaneDirection nesnelerinin listesini içerir.

Örnek şerit yardımı yapılandırması.

Kullanıcının bir şeritte gitmesi önerilen yön, isRecommended alanıyla işaretlenir.

Şerit yardımı örneği

Aşağıdaki snippet, yukarıda gösterilen şeritlerin veri temsilini göstermektedir.

// Lane 1
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false},
                  {/*laneShape=*/ SLIGHT_LEFT, /*isRecommended=*/ true}]

// Lane 2
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false}]

Manevralar için simge oluşturma

Maneuver enum, navigasyon sırasında gerçekleşebilecek her olası manevrayı tanımlar. Belirli bir adım için manevrayı StepInfo.getManeuver() yönteminden alabilirsiniz.

Manevra simgeleri oluşturmanız ve bunları ilgili manevralarla eşlemeniz gerekir. Bazı manevralar için DESTINATION_LEFT ve DESTINATION_RIGHT gibi bir simgeyle bire bir eşleme ayarlayabilirsiniz. Ancak bazı manevralar benzer olduğundan, tek bir simgeyle birden fazla manevrayı eşlemek isteyebilirsiniz. Örneğin, TURN_LEFT ve ON_RAMP_LEFT, sola dönüş simgesiyle eşlenebilir.

Bazı manevralar, SDK'nın bir ülkenin sürüş tarafına göre belirlediği ek bir clockwise veya counterclockwise etiketi içerir. Örneğin, trafiğin soldan aktığı ülkelerde sürücüler döner kavşaklarda veya U dönüşü yaparken saat yönünde hareket ederken trafiğin sağdan aktığı ülkelerde saat yönünün tersine hareket ederler. Navigation SDK, manevranın soldan veya sağdan akan trafikte gerçekleşip gerçekleşmediğini algılar ve uygun manevrayı gösterir. Bu nedenle, manevra simgeniz saat yönünde ve saat yönünün tersine manevralar için farklı olabilir.

Farklı manevralar için örnek simgeleri görmek üzere genişletin

Örnek Simgesi 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 kullanma

Navigation SDK tarafından sağlanan, oluşturulmuş simgelerin küçük bir listesi.

Navigation SDK, Android Auto kullanım alanlarını kolaylaştırmak için manevra ve şerit kılavuzu simgelerinin oluşturulmasını destekler. Bu simgeler, 500 x 74 dp sınırlayıcı kutuyu hedeflemeyi öneren Android Auto Arabalar için Uygulama Kitaplığı'nın resim boyutlandırma kılavuzuna uygundur. Ayrıntılar için Android referans belgelerindeki setsLaneImage ve CarIcon bölümlerine bakın.

Simge oluşturma örneği

NavigationUpdatesOptions options =
  NavigationUpdatesOptions.builder()
             .setNumNextStepsToPreview(numNextStepsToPreview)
             .setGeneratedStepImagesType(GeneratedStepImagesType.BITMAP)
             .setDisplayMetrics(getResources().getDisplayMetrics())
             .build();
boolean isRegistered =
          navigator.registerServiceForNavUpdates(
              getPackageName(),
              NavInfoReceivingService.class.getName(),
              options);

Simge oluşturmayı etkinleştirdikten sonra TurnbyTurn StepInfo nesnesi, maneuverBitmap ve lanesBitmap alanlarını simgelerle doldurur.

Sırada ne var?