https://github.com/mapbox/mapbox-java
The Mapbox Java SDK – Java wrappers around Mapbox APIs and other location data
https://github.com/mapbox/mapbox-java
android directions geocoding geojson java mapbox navigation turf
Last synced: 15 days ago
JSON representation
The Mapbox Java SDK – Java wrappers around Mapbox APIs and other location data
- Host: GitHub
- URL: https://github.com/mapbox/mapbox-java
- Owner: mapbox
- License: mit
- Created: 2016-04-06T20:30:35.000Z (about 9 years ago)
- Default Branch: main
- Last Pushed: 2025-03-13T14:27:10.000Z (3 months ago)
- Last Synced: 2025-04-06T12:05:33.954Z (about 2 months ago)
- Topics: android, directions, geocoding, geojson, java, mapbox, navigation, turf
- Language: Java
- Homepage: https://docs.mapbox.com/android/java/overview/
- Size: 22 MB
- Stars: 430
- Watchers: 109
- Forks: 120
- Open Issues: 83
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
Build powerful Java apps using Mapbox's tools and services
The Mapbox Java SDK contains directions, geocoding, and many more APIs to use inside your Android or Java application. This repository holds the source code for the project and is divided into several modules to make it easier for developers to only include the dependencies needed for their project.
## Getting Started
If you are looking to include this inside your project, please take a look at [the detailed instructions](https://www.mapbox.com/android-docs/java-sdk/overview/#installation) found in our docs. If you are interested in building from source, read the contributing guide inside of this project.
## Documentation
You'll find all of the documentation for this SDK on [our Mapbox Java documentation page](https://www.mapbox.com/android-docs/java-sdk/overview/). This includes information on installation, using the APIs, and links to the API reference.
## Getting Help
- **Need help with your code?**: Look for previous questions on the [#mapbox tag](https://stackoverflow.com/questions/tagged/mapbox+android) — or [ask a new question](https://stackoverflow.com/questions/tagged/mapbox+android).
- **Have a bug to report?** [Open an issue](https://github.com/mapbox/mapbox-java/issues/new). If possible, include the version of Mapbox Java, a full log, and a project that shows the issue.
- **Have a feature request?** [Open an issue](https://github.com/mapbox/mapbox-java/issues/new). Tell us what the feature should do and why you want the feature.
## Using Snapshots
If you want to test recent bugfixes or features that have not been packaged in an official release yet, you can use a `-SNAPSHOT` release of the current development version of the Mapbox Java SDK via Gradle, available on [JFrog](https://oss.jfrog.org/artifactory/oss-snapshot-local/com/mapbox/mapboxsdk/). There are several different snapshots built nightly. Feel free to use any of the modules as needed.
```gradle
repositories {
maven {
url 'https://api.mapbox.com/downloads/v2/snapshots/maven'
authentication {
basic(BasicAuthentication)
}
credentials {
username = "mapbox"
password = "{secret Mapbox token with DOWNLOADS:READ scope, the same as the token used for the release repository}"
}
}
}
dependencies {
implementation 'com.mapbox.mapboxsdk:mapbox-sdk-services:6.9.0-SNAPSHOT'
}
```
## Sample code
View [the CLI samples](https://github.com/mapbox/mapbox-java/tree/main/samples/src/main/java/com/mapbox/samples) or download the [Mapbox Demo App](https://play.google.com/store/apps/details?id=com.mapbox.mapboxandroiddemo) to see what's possible with the Mapbox Java SDK. You can also visit the [Mapbox Android examples page](https://www.mapbox.com/android-docs/java-sdk/examples) for additional code examples.
## Contributing
All libraries are contained within the `mapbox` folder. You can import the project using Android Studio or IntelliJ IDEA. Read [the contribution guide](https://github.com/mapbox/mapbox-java/blob/main/CONTRIBUTING.md) to get setup properly.