Uygulamanız, Android için Gezinme 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ınabilmesini ve tek görünümlü 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
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:
- Navigasyon SDK'sı ile kullanım için sağlanan bir API anahtarı. Google Cloud Console ana kontrol panelindeki proje adının altında proje kimliğinizi sağlamanız gerekir.
- SDK yapısı. Projenizin, Gezinme SDK'sı için Maven kullanacak şekilde yapılandırıldığından emin olun.
- 4.99.0 ve önceki sürümleri kullanan projeler için. Maven'i kullanamıyorsanız sıkıştırılmış dosyayı paylaşılan Google Drive'dan indirebilirsiniz. Statik kitaplık dosyası, AAR paketi olarak Gezinme SDK'sını içeren
libs/
dizinindeki .aar dosyasıdır. - Bir veya daha fazla demo uygulaması
- Android Studio, Gezinme SDK'sı ile bir 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ından itibaren aşağıdaki demo uygulamalarının her ikisi de GitHub'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 demosunu GitHub'da bulabilirsiniz.
Köprü
Android Studio'da demo uygulamayı içe aktarın ve Gradle'ın çalışmasına izin verin.
local.defaults.properties
uygulamasını açın veMAPS_API_KEY
özelliğinin değerini güncelleyin:MAPS_API_KEY=YOUR_API_KEY
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
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örmdash;Bir sanal cihazı yapılandırmak için Android Virtual Device (AVD) Yöneticisi'ni kullanın. Bir emülatör seçerken Google API'lerini içeren bir görüntü seçtiğinizden emin olun.
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.
NavViewActivity ve NavFragmentActivity seçenekleri
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: NavFragmentActivity
adlı ikinci seçenek, Navigator
ile birlikte SupportNavigationFragment
kullanarak davranışları gösterir.
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
sayfasında aşağıdaki yaygın kalıplar gösterilmiştir:
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 demosunu GitHub'da bulabilirsiniz.
Köprü
Android Studio'da demo uygulamayı içe aktarın ve Gradle'ın çalışmasına izin verin.
local.defaults.properties
uygulamasını açın veMAPS_API_KEY
özelliğinin değerini güncelleyin:MAPS_API_KEY=YOUR_API_KEY
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 gizli anahtarlar eklentisini inceleyin.
Çalışıyor
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) Yöneticisi'ni kullanın. Bir emülatör seçerken Google API'lerini içeren bir görüntü seçtiğinizden emin olun.
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.