Demoyu deneyin

Android için Navigasyon SDK'sını entegre ederek uygulamanız harici bir harita görünümüne bağlanmanın ötesine geçebilir. Google Haritalar navigasyonu sayesinde, uygulamanız bir kullanıcının yolculuğuyla ilgili verilerin dinamik alınmasını ve tek bir bakış açısıyla raporlanmasını sunabilir. Bu kılavuzda, GitHub'da bulunan Navigation SDK demo uygulamalarının nasıl çalıştırılacağı açıklanmaktadır.

Hazırlık

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

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

Demo uygulamaları indirin

Google, deneyim düzeyinize bağlı olarak, Google Haritalar API'lerine ek olarak Gezinme SDK'sının neler sunduğunu anlamanıza yardımcı olacak iki uygulama sunar. Google Haritalar API'lerine aşina olan geliştiriciler GoogleGezinme demosuna odaklanabilir. Her iki projede de yeni olan geliştiriciler her iki uygulamayı da faydalı bulacaktır.

Android için Navigation SDK'sı 4.1 sürümünden itibaren aşağıdaki iki demo uygulamayı GitHub'dan indirebilirsiniz.

  • GoogleGezinme demosu: Rehberli gezinme oturumunda kullanıcı deneyimiyle ilgili API davranışları ve görünümlerinin entegrasyonunu gösterir.

  • GoogleHarita demosu: GoogleMap arayüzünün bağımsız davranışlarını sergileyerek haritaların hissini ve sunumunu özelleştirmek.

GoogleNavigation demosu

En son GoogleNavigation demosunu GitHub'da bulabilirsiniz.

Köprü

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

  2. local.defaults.properties dosyasını açın ve MAPS_API_KEY mülkünün değerini güncelleyin:

      MAPS_API_KEY=YOUR_API_KEY

  3. build'i (derle) tıklayın ve SDK uygulama ayrıntılarını inceleyin.

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

    • Düzen XML'sinde düzen tasarımını ve metni not edin.

    • build.gradle dosyasında, bağımlılıklarda 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ışıyor

  1. Bilgisayarınıza bir Android cihaz 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.
    • Emulator: Sanal bir 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 resim seçtiğinizden emin olun.

  2. Android Studio'da, Ç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çenekler listesinin yer aldığı bir açılış sayfası sunar.

NavSDK'yi yeni kullanmaya başlayanlar bu iki seçeneği muhtemelen en yararlı bulacaktır.

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

2. Seçenek: NavFragmentActivity başlıklı ikinci seçenekte, Navigator ile birlikte SupportNavigationFragment kullanılarak oluşturulan davranışlar gösterilir.

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

  • gezinme 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şımı
  • daha fazla seçenek sunan bir taşma menüsü

Başlamak için Hedefi Ayarla'yı tıklayın ve bir adres seçin. Uygulama daha sonra, bulunduğunuz yerden ilgili adrese yaptığınız yolculuğu simüle eder. API çağırdığınızda ne olacağını görmek için kontrol paneli yer paylaşımını kullanın. Örneğin, SDK'nın nasıl göründüğünü görmek için Yöntemleri Görüntüle'yi tıklayarak SDK'yı gece moduna zorlamayı deneyebilirsiniz.

Değişme MapAndNavActivity seçeneği

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

Google Map demosu

En son GoogleNavigation demosunu GitHub'da bulabilirsiniz.

Köprü

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

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

      MAPS_API_KEY=YOUR_API_KEY

  3. build'i (derle) tıklayın ve SDK uygulama ayrıntılarını inceleyin.

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

    • Düzen XML'sinde düzen tasarımını ve metni not edin.

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

API anahtarının manifeste nasıl eklendiği hakkında daha fazla bilgi için secrets gradle eklentisi bölümüne bakın.

Çalışıyor

  1. Bilgisayarınıza bir Android cihaz 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 talimatlara bakın.
    • Emülatör Sanal cihaz yapılandırmak için Android Virtual Device (AVD) Manager'ı kullanın. Emülatör seçerken Google API'lerini içeren bir resim seçtiğinizden emin olun.

  2. Android Studio'da Ç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 demo listesinin yer aldığı bir açılış sayfası sunar.

Bu sunum kalıbı ve kaynak kodun karşılık gelen yapısı, Google Haritalar SDK'sı demolarını kullananlar için tanıdık olmalıdır. Bunun nedeni, GoogleHarita demosunun Google Haritalar API'si demo uygulamasına benzeyecek şekilde tasarlanmasıdır. En önemli fark, Navigasyon SDK'sı demosunun, kullanıcıya uygun durumlarda NavigationView veya MapView üzerinde test çalıştırmak istediği görünüm sınıfını seçme olanağı sağlamasıdır.

Google genellikle kullanıcıları NavigationView kullanmaya teşvik eder. Bu demo, demo uygulamamızda bu davranışları her iki sürümde de deneme ve sizin için en uygun olanı seçme esnekliği sunar. Örneğin, söz konusu sınıfla etkileşim kurmayı bekleyen bir üçüncü taraf kitaplığı kullandığınızda MapView kullanmaya devam etmeniz gerekebilir.