Gowei

Gowei is a library that handles Maps & Location kit integration (Huawei, Google)

As you may now, if you try to run an application that use Google maps or use play services for location on a Huawei device, it won't work and vice versa.

So by using Gowei, you'll just have to choose which flavor you want to build.

Including in your project

Gradle

Add below codes to your root build.gradle file (not your module build.gradle file).

allprojects {
    repositories {
        mavenCentral()
    }
}

And add a dependency code to your module's build.gradle file.

dependencies {
    implementation "com.appfiza.android:gowei:1.0.2"
}

In your app module's build.gradle file, add the following flavors

flavorDimensions "devices"
  productFlavors {
      huawei {
          dimension "devices"
      }
      google {
          dimension "devices"
      }
  }

SETUP

Before starting using Gowei, you need to do some configurations.

HUAWEI

Start by adding your app to AppGallery Connect console, check the following tutoriel HMSPreparation.

GOOGLE

You have to get a key for your map by following this Google Maps Platform.

Usage

Basic Example - Location

Here is a basic example of implementing Gowei Location
.

val goweiLocation = GoweiLocation()
goweiLocation.init(
  activity = this,
  rationalMessage = "Rational message",
  keepTracking = true,
  locationListener = object : YLocation.LocationListener {
     override fun onLocationFailed() {
  
    }

    override fun onLocationChanged(location: Location) {
     
    }
 })

And you need to add this to your activity/fragment

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    goweiLocation.onActivityResult(requestCode, resultCode, data)
}

override fun onRequestPermissionsResult(
    requestCode: Int,
    permissions: Array<out String>,
    grantResults: IntArray
) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults)
    goweiLocation.onRequestPermissionsResult(requestCode, permissions, grantResults)
}

Requesting location

goweiLocation.requestLocation()

Stop requesting location

goweiLocation.stopRequestingLocation()

Basic Example - Map

Here is a basic example of implementing Gowei Map
.

First thing you need to add this to your layout file

<include
    android:id="@+id/myMap"
    layout="@layout/gowei_map"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

And in code

  val goweiMap = GoweiMap(activity = this, fragmentManager = supportFragmentManager)
  goweiMap.init()

And you need to use setMapReadyListener before doing anything

  goweiMap.setMapReadyListener {
      // Here your start doing things
      onMapReady()
  }

Adding/Updating/Deleting markers

To add a marker, you just need an ID and the latitude and longitude, so for adding

goweiMap.addMarker("markerId_1", 36.763825, 3.048627)

Updating marker's position

goweiMap.withMarker("markerId_1").position(36.763825, 3.048627)

Removing a marker

goweiMap.withMarker("markerId_1").remove()

Animating camera

goweiMap.animateCamera(36.763825, 3.048627, 18F) // 18F is the camera zoom

And for more examples on how to integrate it and using it, please check the sample.

Gowei Map methods

Here is all methods that Gowei Map has for now.

fun init()
fun isMarkerAvailable(markerID: String): Boolean
fun getTargetCameraPosition(): Position
fun enableMarkerClick()
fun disableMarkerClick()
fun animateCameraZoomBy(zoomBy: Float, zoom: Int)
fun animateCameraZoomIn(zoom: Int)
fun isScrollGesturesEnabled(): Boolean
fun setMarkerPositionListener(markerPositionListener: (Position) -> Unit)
fun setOnCameraIdleListener(cameraIdleListener: (() -> Unit))
fun setScrollGesturesEnabledDuringRotateOrZoom(enabled: Boolean)
fun setRotateGesture(enabled: Boolean)
fun setTiltGesturesEnabled(enabled: Boolean)
fun setCompassEnabled(enabled: Boolean)
fun setMyLocationButtonEnabled(enabled: Boolean)
fun setScrollGesturesEnabled(enabled: Boolean)
fun setZoomControlsEnabled(enabled: Boolean)
fun setAllGesturesEnabled(enabled: Boolean)
fun setMapType(mapType: Int)
fun setMapStyle(context: Context, resId: Int): Boolean
fun animateCamera(lat: Double, lng: Double, zoom: Float)
fun animateCameraWithBounds(positions: List<Position>, zoom: Int)
fun moveCamera(lat: Double, lng: Double, zoom: Float)
fun addPolyline(polylineEncoded: String, width: Float? = null, color: Int? = null)
fun setPadding(left: Int, top: Int, right: Int, bottom: Int)
fun clear()

License

Copyright 2021 BackPackerDz (Fayçal Kaddouri)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

BackPackerDz/Gowei