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 navigasyonu ile uygulamanız, kullanıcının yolculuğuyla ilgili verilerin dinamik olarak alınmasını ve tek 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ırlanın

Navigation SDK'yı kullanmaya başlamak için aşağıdaki öğelere sahip olmanız gerekir.

• Navigation SDK ile kullanılmak üzere sağlanan bir API anahtarı. Anahtar oluşturma ve kısıtlama hakkında daha fazla bilgi için API anahtarlarını kullanma başlıklı makaleyi inceleyin.
• SDK yapısı. Projenizin, Navigasyon SDK'sı için Maven'i kullanacak şekilde yapılandırıldığını doğrulayın.
• Demo uygulamalardan biri veya daha fazlası.
• Android Studio, Navigation SDK ile uygulama oluşturmak için önerilen geliştirme ortamıdır.

Bu doküman, 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 bilmeniz gerekir.

Demo uygulamaları edinme

Google, deneyim düzeyinize bağlı olarak Navigasyon SDK'sının Google Haritalar API'lerine ek olarak sunduğu özellikleri anlamanıza yardımcı olacak iki uygulama sunar. Google Haritalar API'lerini bilen geliştiriciler, GoogleNavigation demosuna odaklanabilir. Her iki projede de yeni olan geliştiriciler, her iki uygulamayı da faydalı bulacaktır.

Android için Navigasyon SDK'sı v4.1 itibarıyla aşağıdaki demo uygulamaların her ikisi de GitHub'da indirilebilir.

• GoogleNavigation demosu: API davranışlarının ve görünümlerinin, rehberli gezinme oturumu sırasında kullanıcı deneyimiyle ilgili olarak nasıl entegre edildiğini gösterir.

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

GoogleNavigation demosunu

En yeni GoogleNavigation demosunu GitHub'da bulabilirsiniz.

Derleme

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

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

     MAPS_API_KEY=YOUR_API_KEY
   

3. Oluştur'u 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ına ve metne dikkat edin.

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

API anahtarının manifeste nasıl eklendiği hakkında daha fazla bilgi için Secrets Gradle eklentisi dokümanlarına bakın.

Çalıştır

1. Android cihazı 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 talimatlara bakın.
   • Emülatör: Sanal cihazı yapılandırmak için Android Sanal Cihaz (AVD) Yöneticisi'ni kullanın. Bir emülatör seçerken Google API'lerini içeren bir resim 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.

Oluşturulup başlatılan uygulama, kullanıcıya bir seçenek listesinin açılış sayfasını gösterir.

NavViewActivity ve NavFragmentActivity seçenekleri

NavSDK'yı yeni kullanmaya başlayanlar bu iki seçeneği en kullanışlı bulacaktır.

1. seçenek: NavViewActivity, NavigationView ile Navigator'nın birlikte kullanıldığı davranışları gösterir.

2. seçenek: NavFragmentActivity başlıklı ikinci seçenekte, Navigator ile birlikte NavigationFragment 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'de yöntemleri dinamik olarak çağırmak için etkileşimde bulunabileceğiniz bir yer paylaşımı
• 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 daha sonra mevcut konumunuzdan bu adrese bir gezi 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'yı gece moduna zorlayarak nasıl göründüğünü görmek için Görüntüleme Yöntemleri'ni tıklayın.

SwappingMapAndNavActivity seçeneği

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

• MapView gösteriliyorsa
• Navigasyon başladığında NavigationView'a geçiş yapma
• Navigasyon sona erdiğinde MapView'a dönme

GoogleMap demosu

En yeni GoogleNavigation demosunu GitHub'da bulabilirsiniz.

Derleme

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

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

     MAPS_API_KEY=YOUR_API_KEY
   

3. Oluştur'u 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ına ve metne dikkat edin.

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

API anahtarının manifeste nasıl eklendiği hakkında daha fazla bilgi için Secrets Gradle eklentisi başlıklı makaleyi inceleyin.

Çalıştır

1. Android cihazı 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 talimatlara bakın.
   • Emülatör Sanal cihazı yapılandırmak için Android Sanal Cihaz (AVD) Yöneticisi'ni kullanın. Bir emülatör seçerken Google API'lerini içeren bir resim 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 oluşturulup başlatıldığında kullanıcıya bir demo listesinin açılış sayfası gösterilir.

Bu sunum kalıbı ve kaynak kodun ilgili yapısı, Google Haritalar SDK demolarının kullanıcıları tarafından biliniyor olmalıdır. Bunun nedeni, GoogleMap demosunun Maps API demo uygulamasına benzer şekilde tasarlanmış olmasıdır. Aradaki temel fark, Navigasyon SDK'sı demosunun kullanıcının demo çalıştırmak istediği görünüm sınıfını seçmesine olanak tanımasıdır: NavigationView veya MapView (uygun olduğu durumlarda).

Google genellikle bu özelliği kullananların NavigationView kullanmasını önerir. Bu demo, demo uygulamamızdaki her iki sürümde de bu davranışları deneme ve sizin için uygun olanı seçme esnekliği sunar. Örneğin, bu sınıfla etkileşim kurmayı bekleyen bir üçüncü taraf kitaplığı kullandığınız durumlarda MapView kullanmanız gerekebilir.