Map initialization

The Maps SDK for Android allows you to initialize the map with a setup configuration. For this purpose, use the MapFragment.newInstance() method or MapView constructor with MapProperties. The MapProperties object allows you to set initial map values of the map.

Initializing the map with bounding box

Programmatically:

1val amsterdamTopLeft = LatLng(52.499782, 4.749553)
2val amsterdamBottomRight = LatLng(52.246161, 5.031764)
3val boundingBox = BoundingBox(amsterdamTopLeft, amsterdamBottomRight)
4val focusArea: CameraFocusArea = CameraFocusArea.Builder(boundingBox)
5    .pitch(5.0)
6    .bearing(MapConstants.ORIENTATION_NORTH.toDouble())
7    .build()
8val apiKeys = mapOf(ApiKeyType.MAPS_API_KEY to BuildConfig.MAPS_API_KEY)
9val mapProperties = MapProperties.Builder()
10    .cameraFocusArea(focusArea)
11    .keys(apiKeys)
12    .build()
13mapFragment = MapFragment.newInstance(mapProperties)

From XML:

1<com.tomtom.online.sdk.map.MapView
  android:id="@+id/map_view"
  android:name="com.tomtom.online.sdk.map.MapFragment"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  app:cameraFocusAreaTopLeftLatitude="52.499782"
  app:cameraFocusAreaTopLeftLongitude="4.749553"
  app:cameraFocusAreaBottomRightLatitude="52.246161"
  app:cameraFocusAreaBottomRightLongitude="5.031764"
  app:cameraFocusAreaPitch="5.0"
  app:cameraFocusAreaBearing="0.0" />

Centering the map with starting point

Programmatically:

1val tomtomOfficeLodz = LatLng(51.759434, 19.449011)
2val cameraPosition = CameraPosition.builder()
3    .focusPosition(tomtomOfficeLodz)
4    .zoom(MapConstants.DEFAULT_ZOOM_LEVEL)
5    .pitch(5.0)
6    .bearing(MapConstants.ORIENTATION_NORTH.toDouble())
7    .build()
8val apiKeys = mapOf(ApiKeyType.MAPS_API_KEY to BuildConfig.MAPS_API_KEY)
9val mapProperties = MapProperties.Builder()
10    .cameraPosition(cameraPosition)
11    .keys(apiKeys)
12    .build()
13mapFragment = MapFragment.newInstance(mapProperties)

From XML:

1<fragment
  android:id="@+id/map_fragment"
  android:name="com.tomtom.online.sdk.map.MapFragment"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  app:cameraPositionLatitude="52.499782"
  app:cameraPositionLongitude="4.749553"
  app:cameraPositionZoom="14.0"
  app:cameraPositionPitch="5.0"
  app:cameraPositionBearing="0.0" />

Map initialized on Lodz Office of TomTom with 15 zoom level

Map initialized on Amsterdam area