В этом руководстве описываются способы настройки карты, которая отображается в приложении Android, когда вы следите за поездкой. Вы можете настроить внешний вид карты следующими способами:
- Оформите карту с помощью стилей облачных карт.
- Настройте камеру, чтобы сосредоточиться на поездке
- Настройка маркеров
- Настройка полилиний
Оформите карту с помощью стилей облачных карт.
Настройте внешний вид компонента карт, используя стили облачных карт. Вы создаете и редактируете стили карт в консоли Google Cloud для любого из своих приложений, использующих Карты Google, без каких-либо изменений в коде. Дополнительную информацию см. в разделе Стилизация облачных карт .
Классы ConsumerMapView
и ConsumerMapFragment
поддерживают стили облачных карт . Чтобы использовать стили облачных карт, убедитесь, что выбранный модуль визуализации карт — LATEST
. В следующих разделах показаны примеры использования стилей облачных карт в вашем проекте.
ConsumerMapView
Чтобы использовать стиль облачных карт в ConsumerMapView
, установите поле mapId
в GoogleMapOptions
и передайте GoogleMapOptions
в getConsumerGoogleMapAsync(ConsumerMapReadyCallback, Fragment, GoogleMapOptions) или getConsumerGoogleMapAsync(ConsumerMapReadyCallback, FragmentActivity, GoogleMapOptions).
Пример
Ява
public class SampleAppActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
ConsumerMapView mapView = findViewById(R.id.consumer_map_view);
if (mapView != null) {
GoogleMapOptions optionsWithMapId = new GoogleMapOptions().mapId("map-id");
mapView.getConsumerGoogleMapAsync(
new ConsumerMapReadyCallback() {
@Override
public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
// ...
}
},
/* fragmentActivity= */ this,
/* googleMapOptions= */ optionsWithMapId);
}
}
}
Котлин
class SampleAppActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
val mapView = findViewById(R.id.consumer_map_view) as ConsumerMapView
val optionsWithMapId = GoogleMapOptions().mapId("map-id")
mapView.getConsumerGoogleMapAsync(
object : ConsumerGoogleMap.ConsumerMapReadyCallback() {
override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
// ...
}
},
/* fragmentActivity= */ this,
/* googleMapOptions= */ optionsWithMapId)
}
}
ConsumerMapFragment
Существует два способа использования стилей облачных карт в ConsumerMapFragments:
- Статически с XML.
- Динамически с помощью
newInstance
.
Статически с XML
Чтобы использовать стиль облачных карт с XML в ConsumerMapFragment
, добавьте XML-атрибут map:mapId
с указанным mapId
. См. следующий пример:
<fragment
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:map="http://schemas.android.com/apk/res-auto"
android:name="com.google.android.libraries.mapsplatform.transportation.consumer.view.ConsumerMapFragment"
android:id="@+id/consumer_map_fragment"
map:mapId="map-id"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
Динамически с помощью newInstance
Чтобы использовать стиль облачных карт с помощью newInstance
в ConsumerMapFragment
, установите поле mapId
в GoogleMapOptions
и передайте GoogleMapOptions
в newInstance
. См. следующий пример:
Ява
public class SampleFragmentJ extends Fragment {
@Override
public View onCreateView(
@NonNull LayoutInflater inflater,
@Nullable ViewGroup container,
@Nullable Bundle savedInstanceState) {
final View view = inflater.inflate(R.layout.consumer_map_fragment, container, false);
GoogleMapOptions optionsWithMapId = new GoogleMapOptions().mapId("map-id");
ConsumerMapFragment consumerMapFragment = ConsumerMapFragment.newInstance(optionsWithMapId);
getParentFragmentManager()
.beginTransaction()
.add(R.id.consumer_map_fragment, consumerMapFragment)
.commit();
consumerMapFragment.getConsumerGoogleMapAsync(
new ConsumerMapReadyCallback() {
@Override
public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
// ...
}
});
return view;
}
}
Котлин
class SampleFragment : Fragment() {
override fun onCreateView(
inflater: LayoutInflater,
container: ViewGroup?,
savedInstanceState: Bundle?): View? {
val view = inflater.inflate(R.layout.consumer_map_fragment, container, false)
val optionsWithMapId = GoogleMapOptions().mapId("map-id")
val consumerMapFragment = ConsumerMapFragment.newInstance(optionsWithMapId)
parentFragmentManager
.beginTransaction()
.add(R.id.consumer_map_fragment, consumerMapFragment)
.commit()
consumerMapFragment.getConsumerGoogleMapAsync(
object : ConsumerMapReadyCallback() {
override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
// ...
}
})
return view
}
}
Отрегулируйте масштаб камеры, чтобы сосредоточиться на поездке
Во время активного сеанса совместного путешествия вы можете управлять масштабированием и фокусировкой камеры одним из двух способов:
AutoCamera
: Если вы хотите использоватьAutoCamera
, вам не нужно ничего делать. Камера следит за поездкой. Подробности см. вAutoCamera
.Настройте поведение камеры. Чтобы настроить поведение камеры, необходимо отключить
AutoCamera
, а затем выполнить настройки. Подробности см. в разделе Настройка поведения камеры .
AutoCamera
центрирует камеру
Consumer SDK предоставляет функцию AutoCamera
, которая по умолчанию включена во встроенной кнопке «Мое местоположение» в Maps SDK. Камера масштабируется, чтобы сфокусироваться на маршруте совместного путешествия и следующей путевой точке.
Если вы хотите использовать AutoCamera
, обязательно включите ее. Дополнительные сведения см. isAutoCameraEnabled
.
Подробную информацию о кнопке «Мое местоположение» см. в разделе «Кнопка «Мое местоположение» в документации Maps JavaScript API.
Настройте поведение камеры
Чтобы лучше контролировать поведение камеры, выполните следующие действия, чтобы отключить AutoCamera
и настроить поведение камеры вручную.
Отключите
AutoCamera
с помощью ConsumerController.setAutoCameraEnabled() .Получите рекомендуемые границы камеры, используя ConsumerController.getCameraUpdate() .
Предоставьте
CameraUpdate
в качестве аргумента одной из этих функций Android: