woosmap-sdk

Woosmap Android SDK purpose is to offer a full toolkit to ease the integration of Woosmap' services on an Android application. It provides a MapView that you can use to represent any geographical data. You can enrich this MapView with our renderers for various streamlined use-cases. It also contains a full client library to simplify querying our web services.

Configure Gradle to install our SDK

The path to our maven's repository is https://native-sdk.woosmap.com/android/ In settings.gradle.kts file add the path to our maven's repository like this

dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
google()
mavenCentral()
maven {
url = uri("https://native-sdk.woosmap.com/android/")
}
}
}

Then you can add the dependency to our SDK in your gradle's build.gradle.kts module-level file

dependencies {
//...
implementation("com.woosmap:sdk:1.1.1")
//...
}

How to use

In order to authenticate your application you will need to add a meta-data information to specify your private key in the AndroidManifest.xml in your application's tag like so:

<application>
<!-- ... -->
<meta-data android:name="com.woosmap.sdk.privateKey" android:value="YOUR PRIVATE KEY HERE" />
</application>

Once done if you wish to use directly any of the API clients classes you'll need to make sure you have the library initialized before hand in your code (a single call in the MainActivity is enough)

Woosmap.initialize(applicationContext)

Changelog

v1.1.1

  • Add stylersJson properties to support custom styles for a map

  • Add callbacks on MapView when style is loaded, map is loaded or if it fails to do so

  • Add missing documentation for size and minSize parameters of DefaultStyleRule

v1.1.0

  • Change StoresService to support autocomplete, search and bounds

  • Update StoresAutocompleteTextView to use the correct autocomplete API

  • Allow StoresRenderer.select to take null in order to unselect

  • Bump AGP to 8.2.2

  • Bump dependencies versions

  • Use C++17

v1.0.2

  • Change proguard.rules to avoid potential conflict with other dependencies

  • Upgrade AGP to 8.2.1

  • Upgrade to Kotlin and its plugins to 1.9.20

  • Update copyright notice

v1.0.1

  • Added support for the new default icons for IndoorRenderer

  • Added support for the new list_sub_buildings parameters of LocalitiesService

Packages

Link copied to clipboard

Main package containing the configuration singleton and UI components.

Link copied to clipboard

Contains service classes to use various Woosmap APIs.

Link copied to clipboard

Contains models data classes for Distance API.

Link copied to clipboard

Contains models data classes for Indoor API.

Link copied to clipboard

Contains models data classes for Localities API.

Link copied to clipboard

Contains shared models data classes for several APIs.

Link copied to clipboard

Contains models data classes for Stores API.

Link copied to clipboard

Classes to serialize and deserialize GeoJSON data.

Link copied to clipboard

Contains geometry related classes

Link copied to clipboard

Contains helpers to manage location permissions.

Link copied to clipboard

Classes that can be used with the MapView.

Link copied to clipboard

Camera related classes to be used with a MapView.

Link copied to clipboard

Renderers classes used to draw on a MapView.