Tüketici uygulamanızda bir geziyi takip etmek için önce bir harita tanımlamanız ve gerekirse vektör haritaları için destek eklemeniz gerekir.
Uygulamanızda harita ayarlamak için aşağıdaki adımları uygulayın:
- Bir geziyi takip etmek için harita parçası tanımlayın.
- Harita ana katmanı ve görüntü kontrol cihazı desteği ekleyin.
- Gerekirse vektör haritalarını görüntülemek için Android vektör grafikleri desteği ekleyin.
Bir harita tanımladıktan sonra görsel deneyimi özelleştirmek istediğiniz ek görünümler ve kamera kontrolleri ekleyebilirsiniz. Daha fazla bilgi için Haritaya stil uygulama başlıklı makaleyi inceleyin.
1. Adım: Bir geziyi takip etmek için harita parçası tanımlayın
Tüketici uygulamanızda isteğe bağlı bir gezi paylaştığınız haritayı oluşturmak için bir harita parçası veya görünüm ekleyerek harita tanımlarsınız. Haritanızı tanımlamak için aşağıdaki yöntemlerden birini uygulayın:
ConsumerMapFragment
: HaritanızıFragment
ile tanımlamak için kullanın.ConsumerMapView
:View
içeren bir harita tanımlamak için kullanın.
Her iki yöntemde de özellikler aynıdır. Bu nedenle, uygulamanız için en uygun yöntemi seçin.
Her iki yöntem de aşağıdaki bölümde daha ayrıntılı şekilde açıklanmıştır.
Harita fragmanı veya görünümü ekleme
Android fragment'i veya görünüm kullanarak seyahat ilerleme durumunu gösteren bir harita oluşturmak için aşağıdaki adımları uygulayın ve kod örneklerine bakın.
/res/layout
konumundaki uygulama düzeni XML dosyanızda bir parça veya görünüm tanımlayın. Gezi haritasınıConsumerMapFragment
kullanarak bir parça veyaConsumerMapView
kullanarak bir görünüm olarak tanımlayın.Ardından, uygulamanızın erişip değiştirebileceği seyahat haritasına erişim sağlar. Harita,
ConsumerController
için bir tutamaç da sağlar. Bu tutamaç, uygulamanızın tüketici deneyimini kontrol etmesine ve özelleştirmesine olanak tanır.onCreate()
yönteminizdengetConsumerGoogleMapAsync(callback)
'u çağırın. Bu yöntem, geri aramadaConsumerGoogleMap
değerini eşzamansız olarak döndürür.Gezi ilerleme durumunu görüntülemek ve gerektiğinde güncellemek için
ConsumerGoogleMap
simgesini kullanın.
ConsumerMapFragment
ekleme örneği
Aşağıdaki kod örneğinde gösterildiği gibi, uygulama düzeni XML dosyanızda parçayı tanımlayın.
<fragment xmlns:android="http://schemas.android.com/apk/res/android" android:name="com.google.android.libraries.mapsplatform.transportation.consumer.view.ConsumerMapFragment" android:id="@+id/consumer_map_fragment" android:layout_width="match_parent" android:layout_height="match_parent" />
onCreate()
yöntemindengetConsumerGoogleMapAsync()
'e telefon edin.
Java
public class SampleAppActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
// Find the ConsumerMapFragment.
ConsumerMapFragment consumerMapFragment =
(ConsumerMapFragment) fragmentManager.findFragmentById(R.id.consumer_map_fragment);
// Initiate the callback that returns the map.
if (consumerMapFragment != null) {
consumerMapFragment.getConsumerGoogleMapAsync(
new ConsumerMapReadyCallback() {
// The map returned in the callback is used to access the ConsumerController.
@Override
public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
ConsumerController consumerController = consumerGoogleMap.getConsumerController();
}
});
}
}
}
Kotlin
class SampleAppActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
// Find the ConsumerMapFragment.
val consumerMapFragment =
fragmentManager.findFragmentById(R.id.consumer_map_fragment) as ConsumerMapFragment
consumerMapFragment.getConsumerGoogleMapAsync(
object : ConsumerMapReadyCallback() {
override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
val consumerController = consumerGoogleMap.getConsumerController()!!
}
}
)
}
}
ConsumerMapView
ekleme örneği
XML dosyanızda tanımlandığı şekilde, görünümü bir fragmanda veya etkinlikte kullanın.
<com.google.android.libraries.mapsplatform.transportation.consumer.view.ConsumerMapView xmlns:android="http://schemas.android.com/apk/res/android" android:id="@+id/consumer_map_view" android:layout_width="match_parent" android:layout_height="match_parent" />
onCreate()
numaralı telefondangetConsumerGoogleMapAsync()
numaralı telefona arama yapın. Geri çağırma parametresine ek olarak aşağıdaki ayrıntıları ekleyin:İçerdiği etkinlik veya parça. Etkinlik veya parça temel sınıfı, yaşam döngüsüne erişim sağladığından sırasıyla
FragmentActivity
veya destekFragment
olmalıdır.MapView
için yapılandırma özelliklerini içerenGoogleMapOptions
(boş olabilir).
Java
public class SampleAppActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
ConsumerMapView mapView = findViewById(R.id.consumer_map_view);
if (mapView != null) {
mapView.getConsumerGoogleMapAsync(
new ConsumerMapReadyCallback() {
// The map returned in the callback is used to access the ConsumerController.
@Override
public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
ConsumerController consumerController = consumerGoogleMap.getConsumerController();
}
}, this, null);
}
}
}
Kotlin
class SampleAppActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
val mapView = findViewById(R.id.consumer_map_view) as ConsumerMapView
mapView.getConsumerGoogleMapAsync(
object : ConsumerMapReadyCallback() {
// The map returned in the callback is used to access the ConsumerController.
override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
val consumerController = consumerGoogleMap.getConsumerController()!!
}
},
/* fragmentActivity= */ this,
/* googleMapOptions= */ null,
)
}
}
Bir fragmanda MapView
, bir etkinlikte MapView
için önceki örnekle aynıdır. Bunun tek farkı, fragmanın onCreateView()
yönteminde MapView
öğesini içeren düzeni şişirmesidir.
Java
public class MapViewInFragment extends Fragment {
@Override
public View onCreateView(
@NonNull LayoutInflater layoutInflater,
@Nullable ViewGroup viewGroup,
@Nullable Bundle bundle) {
return layoutInflater.inflate(R.layout.consumer_map_view, viewGroup, false);
}
}
Kotlin
class MapViewInFragment : Fragment() {
override fun onCreateView(
layoutInflater: LayoutInflater,
container: ViewGroup?,
savedInstanceState: Bundle?,
): View {
return layoutInflater.inflate(R.layout.consumer_map_view, viewGroup, false)
}
}
2. adım: Haritalar ana katmanı ve görüntüleme denetleyicisi desteği ekleyin
Uygulamanızda gezideki ilerleme durumunu paylaşmak için uygulamanıza aşağıdaki sınıfları ekleyin: ConsumerGoogleMap
ve ConsumerController
.
ConsumerMapFragment
veyaConsumerMapView
'denConsumerGoogleMap
alın. Her ikisi deConsumerMapReadyCallback
içindeConsumerGoogleMap
'yi eşzamansız olarak döndürür.ConsumerGoogleMap
,GoogleMap
sınıfı için bir sarmalayıcı sınıftır. Uygulamanızın harita ile etkileşim kurabilmesi içinGoogleMap
ile eşdeğer bir API kullanır. Bu sayede uygulamanız, temel alınan aynı Google haritasıyla sorunsuz şekilde etkileşim kurabilir. Örneğin,GoogleMap
yalnızca tek bir geri çağırma kaydına izin verir ancakConsumerGoogleMap
çift kayıtlı geri çağırmaları destekler. Bu geri çağırmalar, uygulamanızın sırayla çağrılan geri çağırmaları kaydetmesine olanak tanır.getConsumerController()
'deConsumerGoogleMap
'danConsumerController
alın.ConsumerController
, gezileri izleme, gezi durumunu kontrol etme ve konum belirleme gibi gezi paylaşımı özelliklerine erişim sağlar.
Java ve Kotlin'de uygulamanıza ConsumerGoogleMap
ve ConsumerController
ekleme hakkında bilgi edinmek için aşağıdaki örneklere bakın.
Java
private ConsumerGoogleMap consumerGoogleMap;
private ConsumerController consumerController;
private ConsumerMapView consumerMapView;
consumerMapView.getConsumerGoogleMapAsync(
new ConsumerMapReadyCallback() {
@Override
public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerMap) {
consumerGoogleMap = consumerMap;
consumerController = consumerMap.getConsumerController();
}
},
this, null);
Kotlin
var consumerGoogleMap: ConsumerGoogleMap
var consumerController: ConsumerController
val consumerMapView = findViewById(R.id.consumer_map_view) as ConsumerMapView
consumerMapView.getConsumerGoogleMapAsync(
object : ConsumerMapReadyCallback() {
override fun onConsumerMapReady(consumerMap: ConsumerGoogleMap) {
consumerGoogleMap = consumerMap
consumerController = consumerMap.getConsumerController()
},
/* fragmentActivity= */ this,
/* googleMapOptions= */ null,
}
)
3. Adım: Android vektör grafikleri desteği ekleyin
Uygulama tasarımınız vektör grafikleri desteği gerektiriyorsa aşağıdaki adımları uygulayarak Android cihazlar ve vektör çizilebilir öğeler için destek ekleyin:
- Etkinliğinize aşağıdaki kodu ekleyin. Bu kodlar, Tüketici SDK'sında Vektör çizilebilir öğelerini kullanmak için
AppCompatActivity
'ü genişletir.
Java
// ...
import android.support.v7.app.AppCompatActivity;
// ...
public class ConsumerTestActivity extends AppCompatActivity {
// ...
}
Kotlin
// ...
import android.support.v7.app.AppCompatActivity
// ...
class ConsumerTestActivity : AppCompatActivity() {
// ...
}