Demoyu deneyin

Android için Navigasyon SDK'sını entegre ettiğinizde, uygulamanız harici bir harita görünümüne bağlanmanın ötesine geçebilir. Google Haritalar navigasyonu sayesinde, uygulamanız bir kullanıcının yolculuğuyla ilgili verilerin dinamik alınmasını ve tek bir bakış açısıyla raporlanmasını sunabilir. Bu kılavuzda, GitHub'da bulunan Navigation SDK demo uygulamalarının nasıl çalıştırılacağı açıklanmaktadır.

Not: Navigasyon SDK'sı şu anda yalnızca belirli müşteriler tarafından kullanılabilmektedir ve demo uygulamalarını çalıştırabilmek için SDK'yı etkinleştirmeniz gerekir. Daha fazla bilgi için satış ekibiyle iletişime geçin.

Hazırlık

Önemli: Android için Gezinme SDK'sının 3.0 sürümü itibarıyla, Android için Navigasyon SDK'sının en son sürümünü Maven depomuzdan edinebilirsiniz. Artık SDK'yı almak için tercih edilen yöntem budur. Daha fazla bilgi için Projenizi oluşturma bölümünü inceleyin.

Gezinme SDK'sını 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:

  • Gezinme SDK'sı ile kullanılmak üzere sağlanan bir API anahtarı. Google Cloud Console ana kontrol panelindeki proje adının altında bulabileceğiniz proje kimliğinizi sağlamanız gerekir.
  • SDK yapısı. Projenizin Gezinme SDK'sı için Maven'i 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ış yapıyı ortak Google Drive'dan indirebilirsiniz. Statik kitaplık dosyası, Gezinme SDK'sını AAR paketi olarak içeren libs/ dizinindeki .aar dosyasıdır.
  • Bir veya daha fazla demo uygulaması.
  • 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ı açısından da aşina olmanız 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ı ve Haritalar SDK'sını aynı uygulamada kullanamazsınız.

Demo uygulamaları indirin

Google, deneyim düzeyinize bağlı olarak, Google Haritalar API'lerine ek olarak Gezinme SDK'sının neler sunduğunu anlamanıza yardımcı olacak iki uygulama sunar. Google Haritalar API'lerine aşina olan geliştiriciler GoogleGezinme demosuna odaklanabilir. Her iki projede de yeni olan geliştiriciler her iki uygulamayı da faydalı bulacaktır.

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

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

• GoogleHarita demosu: GoogleMap arayüzünün bağımsız davranışlarını sergileyerek haritaların hissini ve sunumunu özelleştirmek.

Maven'in kullanımıyla ilgili not

Demo uygulamaları, Gradle'daki Artifact Registry eklentisi kullanılarak 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.

Not: 4.99.0 ve önceki sürümlerde, projenizde ham AAR paketini kullanmaya devam etmek istiyorsanız bunu libs dizininden projenize ekleyebilirsiniz. Ardından artifactregistry eklentisine ve ilgili uzak depoya yapılan tüm referansları kaldırmanız ve uygulama düzeyindeki build.gradle öğenizde şu AAR bağımlılığını bildirmeniz gerekir: api(name: '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: local.defaults.properties uygulamasını sağlanan API anahtarıyla güncellemediğiniz sürece uygulama, haritayı yükleyemez.

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

     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.

API anahtarının manifeste nasıl eklendiği hakkında daha fazla bilgi edinmek için Secrets Gradle eklentisi belgelerine bakın.

Çalışıyor

1. Bir 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 instructions inceleyin.
   • Emulator: Sanal bir 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 derlenip başlatıldığında, kullanıcıya seçenekler listesinin yer aldığı bir açılış sayfası sunar.

NavViewActivity ve NavFragmentActivity seçenekleri

NavSDK'yı yeni kullanmaya başlayanlar için muhtemelen bu iki seçenek en yararlı seçenekler olacaktır.

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

2. Seçenek: NavFragmentActivity adlı ikinci seçenek, Navigator ile birlikte SupportNavigationFragment kullanan davranışları gösterir.

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

• gezinme kullanıcı arayüzü
• Uygulamanın menüsünde "Hedefi Ayarla" düğmesi
• API'de yöntemleri dinamik olarak çağırmak için etkileşime geçebileceğiniz bir yer paylaşımı
• 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. Uygulama daha sonra, bulunduğunuz yerden ilgili adrese yaptığınız yolculuğu simüle eder. API çağırdığınızda ne olacağını görmek için kontrol paneli yer paylaşımını kullanın. Örneğin, SDK'yı gece moduna geçirmeyi deneyerek nasıl göründüğüne bakmak için Yöntemleri Göster'i tıklayabilirsiniz.

Değişme MapAndNavActivity seçeneği

Not: Bu seçenek, v1'den v4'e geçişinizde size yardımcı olur. Mümkün olduğunda yalnızca NavigationView kullanmanızı öneririz. Ancak bunu, iki elin birlikte nasıl kullanılacağına dair bir örnek olarak verebiliriz.

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

• MapView gösteriliyor
• gezinme başladığında NavigationView olarak geçiş yaparak
• navigasyon sona erdiğinde MapView'e dönüyor

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: Yerel.defaults.properties, sağlanan API anahtarıyla güncellenene kadar uygulama haritayı yükleyemez.

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

     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.

API anahtarının manifeste nasıl eklendiği hakkında daha fazla bilgi için secrets gradle eklentisi bölümüne bakın.

Çalışıyor

1. Bir 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 instructions bakın.
   • Emülatör: Sanal bir 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 derlenip başlatıldığında kullanıcıya demo listesinin yer aldığı bir açılış sayfası sunar.

Bu sunum kalıbı ve kaynak kodun karşılık gelen yapısı, Google Haritalar SDK'sı demolarını kullananlar için tanıdık olmalıdır. Bunun nedeni, GoogleHarita demosunun Haritalar API demo uygulamasına benzer şekilde tasarlanmasıdır. En önemli fark, Navigasyon SDK'sı demosunun, kullanıcıya uygun durumlarda NavigationView veya MapView üzerinde test çalıştırmak istediği görünüm sınıfını seçme olanağı sağlamasıdır.

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

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