Adım adım yol tarifi veri feed'i, haritaya dayalı navigasyon kılavuzu için tasarlanmamış cihazlara yalnızca navigasyon bilgileri sağlar. Sağlanan öğelerle yaklaşan manevralar için aşağıdakiler sağlanır:

• simgeleri (sol, sağ, U dönüşü)
• döner kavşaklardaki dönüş numaraları
• yol adları
• Sonraki navigasyon adımına veya nihai hedefe tahmini mesafeler ve süre

Tam Navigasyon SDK kullanıcı arayüzünün uygun olmadığı deneyimler (ör. Android Auto veya tam Android yığınının kullanılamadığı küçük ekranlar) oluşturmak için adım adım yol tarifi feed'ini kullanabilirsiniz. Örneğin, iki tekerlekli araç sürücüleri için bu özelliği kullanabilirsiniz. Bu sayede, sürücülerin dikkatini dağıtmadan varış noktalarına daha hızlı ve daha güvenle ulaşmalarına yardımcı olmak için yalnızca navigasyon rehberliği yansıtabilirsiniz.

SDK'yı kullanmak için bir hizmet oluşturup Android için Navigasyon SDK'sına kaydedersiniz. Böylece, yeni navigasyon bilgilerini gerçek zamanlı olarak (navigasyon sırasında yaklaşık saniyede bir) alabilir.

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

Genel Bakış

Bu bölümde, TurnByTurn kitaplığının projelerinize nasıl ekleneceği açıklanmakta ve adım adım yol tarifi işlevini oluşturmayla ilgili üst düzey akış özetlenmiştir.

Maven'i kullanarak TurnByTurn kitaplığını projenize ekleme (önerilen)

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

1. Ortamınızı, ana makine Maven deposuna erişecek şekilde ayarlayın:

   Maven

   pom.xml dosyanıza aşağıdakileri ekleyin:

       <project>
         ...
         <repositories>
           <repository>
             <id>google-maven-repository</id>
             <url>https://maven.google.com</url>
           </repository>
         </repositories>
         ...
       </project>
       
       

   Gradle

   build.gradle dosyanıza aşağıdakileri ekleyin:

   repositories {
       ...
       google()
   }
       

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ını kullanarak TurnByTurn kitaplığını projenize ekleme (alternatif)

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

1. google_turnbyturn_*.jar dosyasını indirip arşivden çıkarın.
2. İndirilen JAR dosyasını projenizin app/libs dizinine kopyalayın.

3. JAR dosyasını derlemenize dahil etmek için build.gradle dosyanıza aşağıdakileri ekleyin.

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

Dönüşümlü Kitaplığı kullanma

Adım adım yol tarifi işlevini etkinleştirmeyle ilgili üst düzey adımlar aşağıda verilmiştir. Aşağıdaki bölümlerde her adımla ilgili ayrıntılı bilgi verilmektedir.

1. Gezinme güncellemeleri almak için bir hizmet oluşturun.

2. Hizmeti kaydedin.

3. Gezinme durumlarını anlama.

Navigasyon güncellemeleri almak için bir hizmet oluşturma

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

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

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

Hizmeti navigasyon güncellemeleri için kaydetme

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

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

Hizmeti başlatma ve durdurma

Navigasyon SDK'sı bağlandığı sürece navigasyon hizmeti etkindir. Navigasyon hizmeti yaşam döngüsünü kontrol etmek için startService() ve stopService() işlevlerini manuel olarak çağırabilirsiniz. Ancak hizmetinizi Navigation SDK'ya kaydettiğinizde hizmetiniz otomatik olarak başlar ve yalnızca kaydını sildiğinizde durur. Uygulamanızı nasıl oluşturduğunuza bağlı olarak, Android dokümanlarında Hizmetlere genel bakış bölümünde açıklanan bir ön plan hizmeti başlatmayı düşünebilirsiniz.

Hizmetin kaydını iptal etme

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

navigator.unregisterServiceForNavUpdates();

Gezinme durumlarını anlama

Gezinmenin mevcut durumunu almak için NavInfo.getNavState() değerini kullanın. Bu değer aşağıdakilerden biridir:

• Yolda: ENROUTE durumu, rehberli navigasyonun şu anda etkin olduğu ve kullanıcının belirtilen rotada olduğu anlamına gelir. Mevcut ve yaklaşan manevra adımı hakkında bilgi edinebilirsiniz.

• Yeni rota çiziliyor: REROUTING, navigasyonun devam ettiği ancak navigasyon cihazının yeni bir rota aradığı anlamına gelir. Henüz yeni rota olmadığı için yaklaşan manevra adımı kullanılamıyor. Örnek uygulamada, navigasyon bilgi ekranında "Yeni rota oluşturuluyor..." mesajı görünür. Bir rota bulunduktan sonra 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, kalan adım talimatlarının gösterilmesini önlemek için navigasyon bilgi ekranını temizler.

Feed ekranını doldurma

Adım adım yol tarifi hizmetinizi oluşturdunuz. Bu bölümde, adım adım yol tarifi feed'i için yol tarifi kartlarını doldurmak üzere kullanabileceğiniz görsel ve metin öğeleri açıklanmaktadır.

Navigasyon kartı bilgi alanları

Kullanıcı rehberli navigasyona girdiğinde, üstte Gezinme SDK'sından doldurulan gezinme verilerini içeren bir gezinme kartı görünür. İlgili resimde bu temel gezinme öğelerine dair bir örnek gösterilmektedir.

Bu tabloda, gezinme bilgilerinin bulunduğu alanlar ve bu alanları nerede bulabileceğiniz gösterilmektedir.

Her gezinme adımı için alanlar	Seyahatin tamamı için alanlar
Bulunduğu yer: StepInfo	Bulunduğu yer: NavInfo
Tam yol adı	Kalan süre
Manevra simgesi	Hedefe olan mesafe
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 nesnelerinin bir listesini içerir.

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

Şerit yardımı örneği

Aşağıdaki snippet'te, yukarıda gösterilen ş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şturma

Maneuver sınıflandırması, gezinme sırasında gerçekleşebilecek her manevrayı tanımlar ve belirli bir adıma ait manevrayı StepInfo.getManeuver() yönteminden alabilirsiniz.

Manevra simgeleri oluşturmanız ve bunları ilişkili manevralarla eşlemeniz gerekir. Bazı manevralar için DESTINATION_LEFT ve DESTINATION_RIGHT gibi bir simgeyle bire bir eşleme oluşturabilirsiniz. Ancak bazı manevralar benzer olduğundan birden fazla manevrayı tek bir simgeyle eşlemek isteyebilirsiniz. Örneğin, TURN_LEFT ve ON_RAMP_LEFT her ikisi de 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, sürüşlerin yolun sol tarafında yapıldığı ülkelerde sürücüler, döner kavşakta veya U dönüşünde saat yönünde hareket eder. Sürüşlerin yolun sağ tarafında yapıldığı ülkelerde ise saat yönünün tersine hareket edilir. Navigasyon SDK'sı, bir manevranın soldaki mi yoksa sağdaki trafikte mi gerçekleştiğini algılar ve uygun manevrayı döndürür. Bu nedenle, manevra simgeniz saat yönünde ve saat yönünün tersine yapılan manevralar için farklı olabilir.

Oluşturulan simgeleri kullanma

Navigasyon SDK'sı, 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ır kutusu hedeflemeyi öneren Android Auto Araba Uygulaması kitaplığının resim boyutlandırma yönergelerine uygundur. Ayrıntılar için Android referans dokümanlarında setsLaneImage ve CarIcon özelliklerine 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?

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