Demoyu deneyin

Android için Navigasyon SDK'sını entegre ettiğinizde uygulamanız, bağlantı oluşturmanın ötesine geçebilir harici bir harita görünümüne geçirebilirsiniz. Google Haritalar navigasyonla, uygulamanız dinamik kullanıcının yolculuğuyla ilgili verilerin alınması ve tek bir bakış açısıyla raporlanması. Bu kılavuz Android cihazınızda gezinme SDK'sı kullanan veya GitHub'da bulabilirsiniz.

Not: Navigasyon SDK'sı şu anda yalnızca belirli müşteriler ve sizin tarafınızdan Demo uygulamaları çalıştırmak için SDK'nın etkinleştirilmesi gerekir. Daha fazla bilgi için satış ekibiyle iletişime geçin.

Hazırlık

Önemli: Android için Navigasyon SDK'sının 3.0 sürümü itibarıyla Android için Gezinme SDK'sının en son sürümünü edinin. Artık SDK'yı almak için tercih edilen yöntem budur. Daha fazla bilgi için bkz. Ayarlarınızı projesi.

Navigasyon SDK'sını kullanmaya başlamak için lütfen şu öğeleri içerir.

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

  • Şununla kullanılmak üzere sağlanan bir API anahtarı: Gezinme SDK'sı. Lütfen proje kimliğini Google Cloud Console ana kontrol panelinde bulabilirsiniz. proje ismini girin.
  • SDK yapısı. Projenizin yapılandırıldığından emin olun Gezinme SDK'sı için Maven'i kullanın.
  • 4.99.0 ve önceki sürümleri kullanan projeler için. Maven'i kullanamıyorsanız Sıkıştırılmış yapıyı ortak Google Drive'dan indirebilir. Statik kitaplık dosyası, Gezinme SDK'sını içeren libs/ dizini olarak AAR paketi.
  • Bir veya daha fazla demo uygulaması.
  • Android Studio, bir uygulama oluşturmak için önerilen geliştirme ortamı gezinme SDK'sı ile.

Bu doküman, Android'de uygulama geliştirme ve programlama kavramlarını öğreneceksiniz. Bunun yanı sıra, Google Kullanıcının bakış açısından haritalar.

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

Demo uygulamaları indirin

Google, reklamcıların ne olduğunu anlamanıza yardımcı olacak Deneyim seviyenize bağlı olarak Google Haritalar API'leri. Google Haritalar API'lerine aşina olan geliştiriciler dikkatlerini GoogleGezinme demosuna odaklayabilir. Her ikisinde de yeni olan geliştiriciler iki uygulama için de faydalı olacaktır.

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

• GoogleGezinme demosu: API davranışlarının ve API davranışlarının entegrasyonunu gösterir Kullanıcı deneyimiyle ilgili olduğundan, kullanıcı odaklı gezinme modunda ile ilgili daha fazla bilgi edinin.

• Google Map demosu: GoogleMap'nın bireysel davranışlarını gösterir arayüzün ekran görüntüsünü ve görünümünü özelleştirmenize olanak tanır.

Maven'in kullanımıyla ilgili not

Demo uygulamaları, SDK yapısını uzak Maven'den indirecek şekilde yapılandırılır deponuzdur. Tüm YouTube TV kampanyalarınızda proje yapılandırma talimatlarını SDK'ya erişmek için.

Not: 4.99.0 ve daha eski sürümlerde, yine de ham AAR'yi kullanmak istiyorsanız paket eklemek isterseniz bunu, libs altından projenize ekleyebilirsiniz dizin. Ardından, tüm artifactregistry referanslarını kaldırmanız gerekir. eklentisini ve ilgili uzak depoyu bildirmeli ve aşağıdaki AAR'yi beyan etmelidir uygulama düzeyindeki build.gradle: api(ad: 'google_navigation', ext: "aar")

GoogleGezinme demosu

En son GoogleGezinme demosu GitHub'da mevcuttur.

Köprü

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

   Not: Uygulama, siz güncelleme yapana kadar haritayı yükleyemez sağlanan API anahtarıyla local.defaults.properties.

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

     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 koduna dikkat edin.

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

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

Secrets Gradle'a göz atın eklenti belgelerine bakın.

Çalışıyor

1. Bir Android cihazı bilgisayarınıza bağlayın veya bir emülatör kullanın.

   • Android cihaz - talimatları Android cihazınızda geliştirici seçeneklerini etkinleştirin ve sisteminizi yapılandırın entegre eder.
   • Emülatör; Android Sanal Cihazı (AVD) kullanın Yöneticinin sanal cihaz yapılandırma Emülatör seçerken Google API'lerini içeren bir resim seçin.

2. Android Studio'da Çalıştır menü seçeneğini (veya oynat düğmesini) tıklayın. icon); bir dağıtım hedefi seçin.

Uygulama derlenip başlatıldığında kullanıcıya bir listenin açılış sayfası sunar sağlayabilir.

NavViewActivity ve NavFragmentActivity seçenekleri

NavSDK'yı yeni kullanmaya başlayanlar için en uygun seçenek bu iki seçenek olabilir yararlı olur.

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

2. Seçenek: NavFragmentActivity adlı ikinci seçenek, davranışların SupportNavigationFragment yanında Navigator.

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

• gezinme kullanıcı arayüzü
• "Hedef Belirle"yi uygulamanın menüsündeki düğme
• yöntemleri dinamik olarak çağırmak için kullanabileceğiniz bir API
• 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. Ardından, uygulama geçerli konumunuzdan söz konusu adrese bir geziyi simüle eder. Kontrolü kullanma paneller yer paylaşımlı olarak gösterilir. Örneğin herkesin SDK'yı gece moduna geçirmeyi denemek için Yöntemleri Görüntüle'yi tıklayarak ne yaptığını yardımcı oluyorum.

Değişme MapAndNavActivity seçeneği

Not: Bu seçenek, v1'den v4'e geçişinizde size yardımcı olur. Önerilerimiz Mümkün olduğunda yalnızca NavigationView kullanıyor olabilirsiniz, ancak bunu bir örneğine bakalım.

SwappingMapAndNavActivity, aşağıdaki yaygın kalıpları sergiler:

• MapView gösteriliyor
• NavigationView ile değiştiriliyor navigasyon başladığında
• MapView'e dönülüyor navigasyon sona erdiğinde

Google Map demosu

Not: Bu uygulama, SDK'nın 4.1 sürümünden önceki sürümlerinde kullanılamaz.

En son GoogleGezinme demosu GitHub'da mevcuttur.

Köprü

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

   Not: Uygulama, siz güncelleme yapana kadar haritayı yükleyemeyecektir local.defaults.properties, temel hazırlığı yapılan API anahtarı ile yapılır.

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

     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 koduna dikkat edin.

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

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

Sırlar bölmesini göster eklenti başlıklı makaleyi okuyabilirsiniz.

Çalışıyor

1. Bir Android cihazı bilgisayarınıza bağlayın veya bir emülatör kullanın.

   • Android cihaz Ayrıntılı bilgi için talimatları geliştirici seçeneklerini etkinleştirin ve algılamasını sağlar.
   • Emülatör Android Sanal Cihazı (AVD) kullanın Yönetici sanal cihaz yapılandırması. Emülatör seçerken Google API'lerini içeren bir resim seçin.

2. Android Studio'da Çalıştır menü seçeneğini (veya oynat düğmesini) tıklayın. icon); bir dağıtım hedefi seçin.

Uygulama derlenip başlatıldığında kullanıcıya bir listenin açılış sayfası sunar örnek olarak verilebilir.

Bu sunu kalıbı ve kaynak kodun karşılık gelen yapısı Google Haritalar SDK'sı demo kullanıcılarına aşina olmalıdır. Bunun nedeni, GoogleHarita demosu, Google Haritalar API'sı demosuna benzer olacak şekilde tasarlanmıştır uygulamasında gösterilir. Birincil Aradaki fark, Navigasyon SDK demosunun, kullanıcıya hangi görüntüleme sınıfını seçmesini test etmek istedikleri durumlar: NavigationView veya MapView, gerekir.

Google genellikle benimseyenleri NavigationView. Bu demo, bu davranışları Google Ads API'sinde her iki sürümde de deneme esnekliği demo uygulamamızı ziyaret edin ve hangisinin size uygun olduğunu seçin. Örneğin, hâlâ üçüncü taraf kullandığınız durumlarda MapView kullanmanız gerekir beklentisini oluşturabilirsiniz.

Önemli: MapView, MapFragment ve SupportMapFragment sınıfları, cihazlarda Google Play Hizmetleri uygulamasının bulunmasını gerektirir. yüklendi. Yeni bir emülatörü yeniden çalıştırırsanız veya çok eski bir cihazı fabrika ayarlarına sıfırlarsanız Android görüntüsü, önceden yüklenmiş çok eski bir Google Play Hizmetleri ile gelebilir. Bu tür durumlarda, otomatik olarak yeni bir sürüm çekmesini beklemeniz gerekir. veya Play Hizmetleri'ni Google Play Store'dan manuel olarak güncelleyebilirsiniz.