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, kullanıcının yolculuğuyla ilgili verilerin dinamik olarak alınmasını ve tek bir bakışta raporlanmasını sağlayabilir. 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 olmanız gerekir.

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'ı kullanıcı açısından da tanımanız gerekir.

Demo uygulamaları edinme

Google, deneyim düzeyinize bağlı olarak Navigation SDK'nın Google Haritalar API'lerinin yanı sıra neler sunduğunu anlamanıza yardımcı olmak için iki uygulama sağlar. Google Haritalar API'lerini bilen geliştiriciler GoogleNavigation demosuna odaklanabilir. Her iki projeye de yeni başlayan 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 demo uygulamaları GitHub'da indirilebilir.

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

  • Google Harita demo'su: Haritaların tarzını ve sunumunu özelleştirmek için GoogleMap arayüzünün ayrı ayrı davranışlarını gösterir.

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çıp MAPS_API_KEY mülkünün 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.

    • Sayfa düzeni XML'inde sayfa düzeni tasarımını ve metnini not edin.

    • build.gradle dosyasında, bağımlılıklar bölümündeki 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.
    • 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 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 oluşturulup kullanıma sunulduğunda kullanıcıya bir seçenek listesinin bulunduğu bir açılış sayfası gösterilir.

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

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 SupportNavigationFragment kullanılarak oluşturulan davranışlar gösterilir.

Bu seçeneklerden birini tıkladığınızda aşağıdakiler 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şimde bulunabileceğiniz bir yer paylaşımı
  • Diğer seçenekleri içeren bir taşma menüsü

Başlamak için Hedef Ayarla'yı tıklayın ve bir adres seçin. Ardından uygulama, mevcut konumunuzdan bu adrese yapılacak bir seyahati simüle eder. 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'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.

SwappingMapAndNavActivity seçeneği

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

Google Haritalar 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çıp MAPS_API_KEY mülkünün 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.

    • Sayfa düzeni XML'inde sayfa düzeni tasarımını ve metnini not edin.

    • build.gradle dosyasında, bağımlılıklar bölümündeki SDK'yı not edin.

API anahtarının Manifest'e nasıl eklendiği hakkında daha fazla bilgi için secrets gradle eklentisine 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.
    • 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 oluşturulup kullanıma sunulduğunda kullanıcıya bir demo listesinin bulunduğu bir açılış sayfası gösterilir.

Bu sunum kalıbı ve kaynak kodun buna karşılık gelen yapısı, Google Haritalar SDK'sı demolarının kullanıcılarına aşina gelecektir. Bunun nedeni, GoogleMap demosunun Haritalar API demo uygulamasına benzer şekilde tasarlanmış olmasıdır. Temel fark, Navigasyon SDK'sı demosunun kullanıcının hangi görünüm sınıfında demo çalıştırmak istediğini seçmesine olanak tanımasıdır: NavigationView veya geçerli olduğu durumlarda MapView.

Google, genellikle özelliği kullanmaya başlayanları 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şime geçmeyi bekleyen bir üçüncü taraf kitaplığı kullandığınızda MapView kullanmaya devam etmeniz gerekebilir.