Demoyu deneyin

Android için Navigasyon SDK'sını entegre ederek uygulamanız, harici bir harita görünümüne bağlantı vermenin ötesine geçebilir. Google Haritalar navigasyon sayesinde uygulamanız, kullanıcının yolculuğuyla ilgili verileri dinamik olarak alabilir ve tek bakışta raporlayabilir. Bu kılavuzda, GitHub'da bulunan Gezinme SDK'sı demo uygulamalarının nasıl çalıştırılacağı açıklanmaktadır.

Hazırlanın

Navigation SDK'yı kullanmaya başlamak için aşağıdaki öğelere sahip olduğunuzdan emin olun.

Bu doküman, Android geliştiricisi ve nesne yönelimli programlama kavramlarına aşina olan kişiler için tasarlanmıştır. Ayrıca, Google Haritalar'ı kullanıcı bakış açısından da tanıyor olmanız gerekir.

Demo uygulamaları indirme

Google, deneyim düzeyinize bağlı olarak, Android için Navigasyon SDK'sının Google Haritalar API'lerine ek olarak neler sunduğunu anlamanıza yardımcı olacak iki uygulama sunar. Google Haritalar API'leri hakkında bilgi sahibi olan geliştiriciler, GoogleNavigation demosuna odaklanabilir. Her iki projeye de yeni başlayan geliştiriciler, her iki uygulamayı da faydalı bulacaktır.

Android için Navigasyon SDK'sı 4.1 sürümünden itibaren, aşağıdaki demo uygulamaları GitHub'dan indirilebilir.

  • GoogleNavigation demosu: Sesli navigasyon oturumu sırasında kullanıcının deneyimiyle ilgili API davranışlarının ve görünümlerinin entegrasyonunu gösterir.

  • GoogleMap demosu: Haritaların görünümünü ve sunumunu özelleştirmek için GoogleMap arayüzünün ayrı ayrı davranışlarını gösterir.

GoogleNavigation demosu

En yeni GoogleNavigation demosu GitHub'da mevcuttur.

Derleme

  1. Android Studio'da demo uygulamasını içe aktarın ve Gradle'ın çalışmasına izin verin.

  2. local.defaults.properties dosyasını açın ve MAPS_API_KEY özelliğinin değerini güncelleyin:

      MAPS_API_KEY=YOUR_API_KEY

  3. Derle'yi tıklayın ve SDK uygulama ayrıntılarını inceleyin.

    • Java sınıfında uygulama kodunu not edin.

    • Düzen XML'inde düzen tasarımını ve metni inceleyin.

    • build.gradle dosyasında, bağımlılıklardaki SDK'yı not edin.

API anahtarının manifest dosyasına nasıl eklendiği hakkında daha fazla bilgi için Secrets Gradle eklentisi belgelerine bakın.

Çalıştır

  1. Android cihazınızı bilgisayarınıza bağlayın veya bir emülatör kullanın.

    • Android cihaz: Android cihazınızda geliştirici seçeneklerini etkinleştirmek ve sisteminizi cihazı algılayacak şekilde yapılandırmak için talimatları inceleyin.
    • Emülatör: Sanal cihaz yapılandırmak için Android Sanal Cihazı (AVD) Yöneticisi'ni kullanın. Emülatör seçerken Google API'lerini içeren bir görüntü seçtiğinizden emin olun.

  2. Android Studio'da Run (Çalıştır) menü seçeneğini (veya oynat düğmesi simgesini) tıklayın ve ardından bir dağıtım hedefi seçin.

Uygulama derlenip başlatıldığında kullanıcıya seçeneklerin listelendiği bir açılış sayfası gösterilir.

NavSDK'yı yeni kullanmaya başlayanlar muhtemelen bu iki seçeneği en yararlı seçenekler olarak görecektir.

1. seçenek: NavViewActivity, Navigator ile birlikte NavigationView kullanarak davranışları gösterir.

2. seçenek: NavFragmentActivity başlıklı ikinci seçenekte, Navigator ile birlikte NavigationFragment kullanan davranışlar gösterilir.

Bu seçeneklerden birini tıkladığınızda aşağıdakiler gösterilir:

  • navigasyon kullanıcı arayüzü
  • Uygulamanın menüsünde "Hedef Belirle" düğmesi
  • API'deki yöntemleri dinamik olarak çağırmak için etkileşim kurabileceğiniz bir yer paylaşımdır.
  • Daha fazla seçenek içeren bir taşma menüsü

Başlamak için Hedef Belirle'yi tıklayın ve bir adres seçin. Uygulama, mevcut konumunuzdan bu adrese bir yolculuk simülasyonu yapar. Bir API'yi çağırdığınızda ne olduğunu görmek için kontrol panelleri yer paylaşımını kullanın. Örneğin, SDK'yı gece moduna zorlayarak nasıl göründüğünü görmek için Yöntemleri Görüntüle'yi tıklayın.

SwappingMapAndNavActivity seçeneği

SwappingMapAndNavActivity, aşağıdaki yaygın kalıpları gösterir:

  • MapView gösteriliyor
  • Navigasyon başladığında NavigationView ile değiştiriliyor
  • navigasyon sona erdiğinde MapView uygulamasına dönme

GoogleMap demosu

En yeni GoogleNavigation demosu GitHub'da mevcuttur.

Derleme

  1. Android Studio'da demo uygulamasını içe aktarın ve Gradle'ın çalışmasına izin verin.

  2. local.defaults.properties dosyasını açın ve MAPS_API_KEY özelliğinin değerini güncelleyin:

      MAPS_API_KEY=YOUR_API_KEY

  3. Derle'yi tıklayın ve SDK uygulama ayrıntılarını inceleyin.

    • Java sınıfında uygulama kodunu not edin.

    • Düzen XML'inde düzen tasarımını ve metni inceleyin.

    • build.gradle dosyasında, bağımlılıklardaki SDK'yı not edin.

API anahtarının manifest dosyasına nasıl eklendiği hakkında daha fazla bilgi için Secrets Gradle eklentisi bölümüne bakın.

Çalıştır

  1. Android cihazınızı bilgisayarınıza bağlayın veya bir emülatör kullanın.

    • Android cihaz Android cihazınızda geliştirici seçeneklerini etkinleştirmek ve sisteminizi cihazı algılayacak şekilde yapılandırmak için talimatları inceleyin.
    • Emülatör Sanal cihaz yapılandırmak için Android Sanal Cihazı (AVD) Yöneticisi'ni kullanın. Emülatör seçerken Google API'lerini içeren bir görüntü seçtiğinizden emin olun.

  2. Android Studio'da Run (Çalıştır) menü seçeneğini (veya oynat düğmesi simgesini) tıklayın ve ardından bir dağıtım hedefi seçin.

Uygulama derlenip başlatıldığında kullanıcıya demoların listesini içeren bir açılış sayfası gösterilir.

Bu sunum kalıbı ve kaynak kodun ilgili yapısı, Google Haritalar SDK'sı demolarını kullananlara tanıdık gelecektir. Bunun nedeni, GoogleMap demosunun Maps API demo uygulamasına benzer şekilde tasarlanmış olmasıdır. Temel fark, Navigasyon SDK'sı demosunun, kullanıcının bir demoyu test etmek istediği görünüm sınıfını seçmesine olanak tanımasıdır: Geçerli olduğu durumlarda NavigationView veya MapView.

Google, genel olarak kullanıcıları NavigationView kullanmaya teşvik eder. Bu demo, demo uygulamamızdaki her iki sürümde de bu davranışları deneme ve size uygun olanı seçme esnekliği sunar. Örneğin, bu sınıfla etkileşim kurması beklenen bir üçüncü taraf kitaplığı kullandığınız durumlarda MapView kullanmanız gerekebilir.