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 olduğunuzdan emin olun.

• Navigasyon SDK'sı ile kullanılmak üzere temel hazırlığı yapılmış bir API anahtarı. Anahtar oluşturma ve kısıtlama hakkında daha fazla bilgi için API Anahtarları Kullanma başlıklı makaleyi inceleyin.
• SDK yapıları. Navigasyon SDK'sı için Maven'i kullanacak şekilde projenizin yapılandırıldığından emin olun.
• Demo uygulamalardan bir veya daha fazlası.
• Navigasyon SDK'sı ile uygulama oluşturmak için önerilen geliştirme ortamı olan Android Studio.

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 iyi bilmeniz gerekir.

Not: Uygulamanız zaten Haritalar SDK'sını kullanıyorsa Navigasyon SDK'sı hem harita katmanı hem de navigasyon özellikleri için Haritalar SDK'sının yerini alır. Navigasyon SDK'sını ve Haritalar SDK'sını aynı uygulamada kullanamazsınız.

Demo uygulamaları indirme

Google, deneyim seviyenize bağlı olarak Navigasyon SDK'sı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 Navigasyon SDK'sı 4.1 sürümü itibarıyla aşağıdaki demo uygulamaları GitHub'da indirilebilir.

• GoogleNavigation demosu: Kullanıcının rehberli gezinme oturumundaki deneyimiyle ilgili API davranışlarının ve görünümlerinin entegrasyonunu gösterir.

• Google Haritalar demosu: 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.

   Not: local.defaults.properties'i, ayrılmış API anahtarıyla güncelleyene kadar uygulama haritayı yükleyemez.

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. 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'sinde düzen tasarımını ve metni not edin.

   • 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ışı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 seçeneklerin yer aldığı bir açılış sayfası gösterilir.

NavViewActivity ve NavFragmentActivity seçenekleri

NavSDK'yi yeni kullanmaya başlayanlar bu iki seçeneği muhtemelen en kullanışlı 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.

Not: Çoğu durumda, doğrudan NavigationView ile etkileşim kurmak yerine NavigationView için sarmalayıcı olan SupportNavigationFragment'i kullanmanızı öneririz. Daha fazla bilgi için Navigasyon haritası etkileşimi en iyi uygulamalarına göz atın.

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şim kurabileceğiniz bir yer paylaşımı
• daha fazla seçenek içeren bir taşma menüsü

Başlamak için Hedefi ayarla'yı tıklayın ve bir adres seçin. Ardından uygulama, mevcut konumunuzdan bu adrese yapılacak bir geziyi 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

Not: Bu seçenek, 1. sürümden 4. sürüme geçişinizde size yardımcı olur. Mümkün olduğunda yalnızca NavigationView kullanmanızı öneririz ancak bu örneği, her ikisini birlikte kullanmanın nasıl bir örnek olduğunu göstermek için sunuyoruz.

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

• MapView gösteriliyor
• Navigasyon başladığında NavigationView simgesine geçme
• Navigasyon sona erdiğinde MapView'a dönme

Google Haritalar demosu

En son GoogleNavigation demosunu GitHub'da bulabilirsiniz.

Not: Uygulamanızdaki GoogleMap nesnesi ile etkileşim kurma hakkında daha fazla bilgi için GoogleMap etkileşimi ile ilgili en iyi uygulamalar başlıklı makaleyi inceleyin.

Köprü

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

   Not: local.defaults.properties dosyasını, ayrılmış API anahtarıyla güncelleyene kadar uygulama haritayı yükleyemez.

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. 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'sinde düzen tasarımını ve metni not edin.

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

API anahtarının Manifest'e nasıl eklendiği hakkında daha fazla bilgi için gizli gradle eklentisini inceleyin.

Ç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 ilgili yapısı, Google Haritalar SDK'sı demolarının kullanıcılarına aşina gelecektir. Bunun nedeni, Google Haritalar demosunun Haritalar API demo uygulamasına benzer şekilde tasarlanmış olmasıdır. Temel fark, Navigasyon SDK'sı demosunun kullanıcıya 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şim kurmayı bekleyen bir üçüncü taraf kitaplığı kullandığınızda MapView kullanmaya devam etmeniz gerekebilir.

Önemli: MapView, MapFragment ve SupportMapFragment sınıfları, cihazlarda Google Play Hizmetleri uygulamasının yüklü olmasını gerektirir. Yeni bir emülatör başlatırsanız veya çok eski bir cihazı fabrika ayarlarına sıfırlarsanız Android resmi, önceden yüklenmiş çok eski bir Google Play Hizmetleri sürümüyle gelebilir. Bu gibi durumlarda, daha yeni bir sürümü otomatik olarak indirmesini beklemeniz veya Play Hizmetleri'ni Google Play Store üzerinden manuel olarak güncellemeniz gerekir.