Skip to content

map.md

Latest commit

 

History

History
129 lines (111 loc) · 4.02 KB

map.md

File metadata and controls

129 lines (111 loc) · 4.02 KB

Map

The map is provided via fragment. This fragment has to be placed in a FrameLayout. To work with the map you have to subscribe to the map observable. The map can be animated via CameraUpdate, use the CameraUpdateFactory to create an instance. Several map types are supported by GMS, unfortunately only two are supported by HMS:

  • MAP_TYPE_NONE
  • MAP_TYPE_NORMAL
  • MAP_TYPE_SATELLITE -> not provided by HMS yet
  • MAP_TYPE_TERRAIN -> not provided by HMS yet
  • MAP_TYPE_HYBRID -> not provided by HMS yet

Setup

Be sure to enable "Maps SDK for Android" in the Google Cloud Console and create an API key. This API key needs to be declared in your Manifest:

<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="..." />

If the app accesses the user's current location by enabling the MyLocation layer, you must request location permission as well (see Location).

Usage

Create the map fragment and add it to a FrameLayout with id mapContainer:

val mapFragment: MapFragment = MapFragment.newInstance()
supportFragmentManager.beginTransaction().apply {
    add(R.id.mapContainer, mapFragment)
    commit()
}

Working with the map:

val mapDisposable: Disposable =
  mapFragment.getMapObservable().subscribeWith(object : DisposableObserver<Map>() {
      override fun onComplete() {}

      override fun onNext(map: Map) {
          val uiSettings = map.getUiSettings()
          uiSettings.isCompassEnabled = true
          uiSettings.isMyLocationButtonEnabled = true
          uiSettings.isRotateGesturesEnabled

          map.isMyLocationEnabled = true
          map.mapType = Map.MAP_TYPE_NORMAL
      }

      override fun onError(e: Throwable) {}
  })

Using the location to animate the camera to the current position:

val fused: FusedLocationProviderClient = FusedLocationProviderFactory.getFusedLocationProviderClient(this)
fused.getLastLocation()
  .addOnSuccessListener { location ->
      if (location != null) {
          val latLng = LatLng(location.latitude, location.longitude)
          val cameraUpdate = CameraUpdateFactory.get().newLatLngZoom(latLng, 13f)
          map.animateCamera(cameraUpdate, 4000, null)
      }
  }

Adding a marker:

map.addMarker(
    MarkerOptions.create()
        .defaultIcon()
        .position(LatLng(47.871026, 13.548118))
)

Adding a circle:

map.addCircle(
    CircleOptions()
        .center(location)
        .radius(100.0)
        .fillColor(Color.YELLOW)
)

Adding a polygon:

val locationHole1: LatLng = LatLng.midPoint(location2, location3)
val locationHole2: LatLng = location1

map.addPolygon(
    PolygonOptions()
        .add(location1)
        .add(location2)
        .add(location3)
        .fillColor(Color.RED)
        .strokeColor(Color.GREEN)
        .strokeWidth(3f)
        .addHole(listOf(locationHole1, locationHole2))
)

Adding a polyline:

map.addPolyline(
    PolylineOptions()
        .add(location1, location2)
        .width(15f)
        .startCap(Cap.RoundCap())
        .endCap(Cap.SquareCap())
        .zIndex(2f)
)

Adding a tile provider:

val tileProvider = TileProvider.create { x, y, zoom ->
    // TODO return a ChoiceSDK tile via Tile.getFactory().create(...)
}
val tileOverlayOptions = TileOverlayOptions.create().tileProvider(tileProvider)
map.addTileOverlay(tileOverlayOptions)

The Google or Huawei map object can be retrieved for use-cases which ChoiceSDK does not provide, e.g. clustering. Please note that you need to add the corresponding GMS/HMS dependencies in your build.gradle file.

val googleMap: com.google.android.gms.maps.GoogleMap? = map.getGoogleMap()
val huaweiMap: com.huawei.hms.maps.HuaweiMap? = map.getHuaweiMap()

Links