Demoyu deneyin

Uygulamanız, Android için Navigasyon SDK'sını entegre ederek harici bir harita görünümüne bağlanmanın ötesine geçebilir. Uygulamanız, Google Haritalar navigasyonu sayesinde sürücünün yolculuğuyla ilgili verilerin dinamik olarak alınıp tek görünümlü raporlanmasını sağlayabilir.

Bu kılavuzda size bir Android Studio projesi sunulmakta, Gezinme SDK'sının nasıl entegre edileceği ve demo uygulamaların nasıl çalıştırılacağı gösterilmektedir.

Gezinme SDK'si, uygulamanızda gezinmenin görünümü ve sesi üzerinde kontrol sahibi olmanızı sağlayan statik bir kitaplıktır. Kitaplık hakkında ayrıntılı bilgi için ayrı bir pencerede Gezinme SDK'sı referansı (Javadoc) sayfasını açın.

Hazırlık

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

  • Aşağıdakilere erişim için bir Google Haritalar Platformu temsilcisi:

  • Android Studio, Gezinme SDK'sı ile uygulama oluşturmak için önerilen geliştirme ortamıdır.

Bu belge, Android geliştirme ve nesne odaklı programlama kavramlarına aşina olan kişiler için tasarlanmıştır. Ayrıca Google Haritalar'a kullanıcı bakışından da aşina olmanız gerekir.

Demo uygulamaları edinin

Google, deneyim düzeyinize bağlı olarak Navigasyon SDK'sının Google Haritalar API'lerine ek olarak neler sunduğunu anlamanıza yardımcı olacak iki uygulama sağlar. Google Haritalar API'leri hakkında bilgi sahibi olan geliştiriciler, dikkatlerini GoogleGezinme demosuna odaklayabilir. İki projeye de yeni başlayan geliştiriciler her iki uygulamayı da faydalı bulacaktır.

Android v4.1 için Gezinme SDK'sı sürümünden itibaren aşağıdaki demo uygulamaların her ikisi de paylaşılan Google Drive'dan indirilebilir.

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

  • Google Map demosu: Haritaların tarzını ve sunumunu özelleştirmek için GoogleMap arayüzünün bağımsız davranışlarını gösterir.

Maven kullanımıyla ilgili bir not

Demo uygulamalar, Gradle'daki Artifact Registry eklentisini kullanarak SDK yapısını uzak Maven deposundan indirecek şekilde yapılandırılır. SDK'ya erişmek için proje yapılandırma talimatlarını uyguladığınızdan emin olun.

GoogleNavigasyon demosu

En son GoogleNavigasyon demosu, paylaşılan Google Drive'ın kök dizininde mevcuttur. Uygulamanın önceki sürümleri "Arşiv"de bulunur. 4.1'den önceki sürümler için uygulama, AAR'nin yanında aynı zip dosyasında paketlenmiştir.

Köprü

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

  2. local.defaults.properties uygulamasını 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 koduna dikkat edin.

    • Düzen XML'sinde düzen tasarımına ve metnine dikkat edin.

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

API anahtarının manifeste nasıl eklendiğiyle ilgili daha fazla bilgi için Secrets Gradle eklentisi dokümanlarına 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 instructions bakın.
    • Emulatormdash;Sanal cihaz yapılandırmak için Android Virtual Device (AVD) Manager'ı kullanın. Bir emülatör seçerken Google API'lerini içeren bir görüntü 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şturulduğunda ve başlatıldığında kullanıcıya bir seçenek listesinin yer aldığı bir açılış sayfası sunar.

NavSDK'nın yeni kullanıcıları büyük olasılıkla bu iki seçeneği en kullanışlı bulacaktır.

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

2. Seçenek: İkinci seçenek olan NavFragmentActivity, Navigator ile birlikte SupportNavigationFragment kullanarak davranışları gösteriyor.

Bu seçeneklerden birini tıkladığınızda şu seçenekler sunulur:

  • gezinme arayüzü
  • Uygulamanın menüsünde "Hedef Ayarla" 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 Ayarla'yı tıklayın ve bir adres seçin. Ardından uygulama, mevcut konumunuzdan bu adrese seyahati simüle eder. Bir API'yi çağırdığınızda ne olduğunu görmek için kontrol paneli yer paylaşımını kullanın. Örneğin, Yöntemleri Göster'i tıklayarak SDK'yı gece moduna geçirerek nasıl göründüğüne bakabilirsiniz.

Değiştirme MapAndNavActivity seçeneği

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

  • MapView görüntüleniyor
  • navigasyon başladığında NavigationView ile değiştiriliyor
  • navigasyon sona erdiğinde MapView konumuna dönüyor

Google Map demosu

En son GoogleNavigasyon demosu, paylaşılan Google Drive'ın kök dizininde mevcuttur. Uygulamanın önceki sürümleri "Arşiv"de bulunur.

Köprü

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

  2. local.defaults.properties uygulamasını 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 koduna dikkat edin.

    • Düzen XML'sinde düzen tasarımına ve metnine dikkat edin.

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

API anahtarının Manifest'e nasıl eklendiğiyle ilgili 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 instructions bakın.
    • Emülatör Sanal bir cihaz yapılandırmak için Android Virtual Device (AVD) Manager'ı kullanın. Bir emülatör seçerken Google API'lerini içeren bir görüntü 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şturulduğunda ve başlatıldığında kullanıcıya bir demo listesi içeren bir açılış sayfası sunar.

Bu sunum kalıbı ve kaynak kodun ilgili yapısı, Google Haritalar SDK'sı demolarının kullanıcıları tarafından bilinmelidir. Bunun nedeni, Google Map demosunun Haritalar API'si demo uygulamasına benzeyecek şekilde tasarlanmış olmasıdır. Başlıca fark, Navigasyon SDK'sı demosunun, kullanıcının uygun durumlarda NavigationView veya MapView üzerinde test çalıştırmak istediği görünüm sınıfını seçebilmesidir.

Google, kullanıcıları genellikle NavigationView kullanmaya teşvik eder. Bu demo, demo uygulamamızın her iki sürümünde de bu davranışları deneme ve sizin için uygun olanı seçme esnekliği sağlar. Örneğin, bir sınıfla etkileşimde bulunmayı bekleyen bir üçüncü taraf kitaplığını kullandığınız durumlarda bir MapView kullanmanız gerekebilir.