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

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

• simgeler (sol, sağ, U dönüşü)
• Döner kavşaklarda rakamları çevir
• yol adları
• bir sonraki navigasyon adımına veya nihai hedefe kalan tahmini mesafeler

Adım adım feed'i, Android Auto veya tam Android yığınının kullanılamadığı küçük ekran ekranları gibi tam Navigasyon SDK kullanıcı arayüzünün uygun olmadığı deneyimler oluşturmak için kullanabilirsiniz. Örneğin, iki tekerlekli araç sürücüleri için bu özelliği kullanabilirsiniz. Burada, minimum dikkat dağıtıcı unsurlarla hedeflerine daha hızlı ve daha güvenli bir şekilde ulaşmalarına yardımcı olmak için yalnızca navigasyonla ilgili rehberliği sağlayabilirsiniz.

SDK'yı kullanmak için bir hizmet oluşturur ve bu hizmeti Android için Navigasyon SDK'sına kaydedersiniz. Böylece, hizmet gerçek zamanlı olarak (gezinme sırasında saniyede bir kez) yeni navigasyon bilgilerini alabilir.

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

Genel bakış

Bu bölümde, TurnByTurn kitaplığının projelerinize nasıl ekleneceği açıklanmakta ve adım adım işlev geliştirmeyle ilgili üst düzey akış özetlenmektedir.

Maven'i kullanarak TurnByTurn kitaplığını projenize ekleyin (önerilir)

Not: Uygulamanızı TurnByTurn kitaplığını içeren Navigasyon SDK'sı ile zaten ayarladıysanız bu adımı atlayabilirsiniz.

TurnByTurn kitaplığının bağımsız bir sürümünü kullanmak için aşağıdaki adımları izleyin:

1. Ortamınızı, ana makine Maven deposuna erişmek için Seyahat ve Sipariş Belgeleri'ndeki Sürücü SDK'sını kullanmaya başlama bölümünde açıklandığı şekilde ayarlayın.

2. Maven veya Gradle yapılandırmanıza aşağıdaki bağımlılığı ekleyin:

   Maven

   <dependencies>
     ...
     <dependency>
       <groupId>com.google.android.maps</groupId>
       <artifactId>google_turnbyturn</artifactId>
       <version>1.0.0</version>
     </dependency>
   </dependencies>
   

   Gradle

   dependencies {
     ...
     implementation 'com.google.android.maps:google_turnbyturn:1.0.0'
   }
   

İndirilen bir JAR dosyası (alternatif) kullanarak TurnByTurn kitaplığını projenize ekleyin

TurnByTurn kitaplığı bu SDK klasöründe JAR dosyası olarak mevcuttur. Erişiminiz yoksa temsilcinizle iletişime geçin.

1. google_turnbyturn_*.jar dosyasını indirin ve sıkıştırılmış dosyaları çıkartın.
2. İndirilen JAR dosyasını projenizin app/libs dizinine kopyalayın.

3. Derlemenize JAR'yi dahil etmek için aşağıdakileri build.gradle öğenize ekleyin.

   dependencies {
      ...
      api fileTree(include: ['*.jar'], dir: 'libs')
   }
   

TurnByTurn Kitaplığını Kullanma

Adım adım işlevselliği etkinleştirmeyle ilgili üst düzey adımları burada bulabilirsiniz. Aşağıdaki bölümlerde her adım hakkında ayrıntılı bilgi verilmektedir.

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

2. Hizmeti kaydedin.

3. Gezinme durumlarını anlayın.

4. Temel öğeleri gösteren bir gezinme ekranı örneğine bakın.

Gezinme güncellemelerini almak için hizmet oluşturma {#service}

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

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

Aşağıdaki örnekte bulunan hizmet, gezinme bilgilerini alır ve verileri gezinme ayrıntılarını içeren bir NavInfo nesnesine dönüştürmek için TurnByTurnManager özelliğini 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 TurnByTurnManager.MSG_NAV_INFO değerine ayarlanan Message.what alanı aracılığıyla tanımlanabilir.

Not: Gezinme SDK'si gelecekte bu aralıktaki mesaj kodlarını kullanabileceğinden mesaj kodları için 7200-7299 değer aralığını bir kenara bıraktığınızdan emin olun.

Hizmeti navigasyon güncellemeleri için kaydetme {#register}

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

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

Hizmeti başlatma ve durdurma

Gezinme hizmeti, Navigasyon SDK'sı ona bağlandığı sürece etkindir. Gezinme hizmet yaşam döngüsünü kontrol etmek için startService() ve stopService() numaralarını 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 belgeleri Hizmetlere genel bakış bölümünde açıklanan bir ön plan hizmeti başlatmayı düşünebilirsiniz.

Hizmet kaydı iptal ediliyor

Gezinme güncellemeleri almayı durdurmak için Navigasyon SDK'sından hizmetin kaydını iptal edin.

navigator.unregisterServiceForNavUpdates();

Gezinme durumlarını anlama {#states}

Aşağıdakilerden biri olan mevcut navigasyon durumunu öğrenmek için NavInfo.getNavState() öğesini kullanın:

• Yoldayım: ENROUTE durumu, rehberli navigasyonun o anda etkin olduğu ve kullanıcının belirtilen rotada olduğu anlamına gelir. Sıradaki manevra adımı hakkında bilgi verilir.

• Yeni rota belirleniyor: REROUTING, navigasyonun devam ettiği ancak gezginin yeni bir rota aradığı anlamına gelir. Henüz yeni rota olmadığı için Yaklaşan manevra adımı mevcut değil. Örnek uygulamada, gezinme bilgi ekranında "Yeni rota belirleniyor..." mesajı görünür. Bir rota bulunduğunda, ENROUTE durumuna sahip bir NavInfo mesajı gönderilir.

• Durduruldu: STOPPED, navigasyonun sona erdiği anlamına gelir. Örneğin, kullanıcı uygulamada gezinmeden çıktığında gezinme durur. Örnek uygulamada STOPPED durumu, kalan adım talimatlarının gösterilmesini önlemek için navigasyon bilgisi ekranını temizler.

Feed ekranını doldur

Adım adım hizmetinizi kurduğunuza göre bu bölümde adım adım feed'de yol gösterici kartları doldurmak için kullanabileceğiniz görsel ve metin öğeleri ele alınmaktadır.

Gezinme kartı bilgi alanları

Sürücü, rehberli navigasyona girdiğinde, üst kısımda Navigasyon SDK'sından doldurulan gezinme tarihini içeren bir gezinme kartı görünür. İlgili resimde bu temel gezinme öğelerinin bir örneği gösterilmektedir.

Bu tabloda, gezinme bilgisi alanları ve bunları nerede bulacağınız gösterilir.

Her gezinme adımıyla ilgili alanlar	Gezinin geneli için alanlar
StepInfo içinde bulundu	NavInfo içinde bulundu
Tam yol adı	Kalan süre
Manevra simgesi	Hedefe uzaklık
Sonraki adıma olan mesafe
Şerit yardımı alanları

Şerit yardımı

Navigasyon SDK'sı, 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 nesnelerin listesini içerir.

Sürücülerin şeritte izlemesi gereken yol, isRecommended alanı aracılığıyla işaretlenir.

Şerit yardımı örneği

Aşağıdaki snippet'te, yukarıda görüntülenen şeritlerin veri temsili gösterilmektedir.

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

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

Manevralar için simgeler oluşturun

Maneuver sıralaması, rotayı izlerken gerçekleşebilecek her manevrayı tanımlar ve StepInfo.getManeuver() yönteminden belirli bir adımdaki manevrayı alabilirsiniz.

Manevra simgeleri oluşturmanız ve bunları ilgili manevralarla eşleştirmeniz gerekir. Bazı manevralarda, DESTINATION_LEFT ve DESTINATION_RIGHT gibi bir simgeyle bire bir eşleme oluşturabilirsiniz. Bununla birlikte, bazı manevralar benzer olduğundan, tek bir simgeyle birden fazla manevra oluşturmak isteyebilirsiniz. Örneğin, TURN_LEFT ve ON_RAMP_LEFT hem sola dönüş simgesiyle eşleşebilir.

Android Auto manevraları: Navigasyon SDK'sındaki manevralar, Android Auto ile bire bir eşlemeye sahiptir ancak türleri Android Auto için doğru biçime dönüştürmeniz gerekir. Android Auto için navigasyonu etkinleştirme bölümünde Doğru manevra türlerini sağlama bölümüne bakın.

Bazı manevralar, SDK'nın ülkenin sürüş yönüne göre belirlediği ek bir clockwise veya counterclockwise etiketi içerir. Örneğin, sürüşün yolun sol tarafında olduğu ülkelerde, sürücüler bir döner kavşağı veya saat yönünde U dönüşü kullanırken, yolun sağ tarafındaki ülkeler saat yönünde hareket eder. Gezinme SDK'sı bir manevranın sol mu yoksa sağ tarafta mı gerçekleştiğini algılar ve uygun manevrayı sağlar. Bu nedenle, saat yönünün tersine manevra için manevra simgeniz farklı olabilir.

Farklı hareketler için örnek simgeleri görmek için genişletin

Örnek Simge	TurnByTurn İşlemleri
	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

Navigasyon SDK'sı, Android Auto kullanım alanlarını kolaylaştırmak için manevra ve şerit yönlendirme simgeleri oluşturmayı destekler. Bu simgeler, Android Auto Araba Uygulaması kitaplığının 500 x 74 dp'lik bir sınırlayıcı kutunun hedeflenmesini öneren resim boyutlandırma kurallarına uymaktadır. Ayrıntılar için Android referans dokümanlarındaki setsLaneImage ve CarIcon bölümlerine bakın.

Not: Simge oluşturma özelliği varsayılan olarak devre dışıdır.

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?

• Android Auto uygulamaları için:
  • Haritayı çizin ve navigasyonu etkinleştirin.