mirror of
https://github.com/googlemaps/android-samples.git
synced 2025-12-08 18:02:20 +00:00
61 lines
2.5 KiB
Markdown
61 lines
2.5 KiB
Markdown
Google Maps Android API Demos
|
||
===================================
|
||
|
||
These are demos for the [Google Maps Android API v2](https://developers.google.com/maps/documentation/android-api/) in Kotlin.
|
||
They demonstrate most of the features available in the API.
|
||
|
||
This app was written for a minSdk of 15 and the v4 support library, but it can be easily adapted to
|
||
use native functionality instead.
|
||
(For example replacing ``SupportMapFragment`` with ``MapFragment``).
|
||
|
||
The Maps SDK for Android samples can be found under the `gms` gradle product flavor, while the Maps SDK V3 BETA samples can be found under the `v3` gradle product flavor. The active product flavor can be modified through Android Studio’s “Build Variants” toolbar options.
|
||
|
||
Pre-requisites
|
||
--------------
|
||
|
||
- Android SDK v27
|
||
- Latest Android Build Tools
|
||
- Android Support Repository
|
||
|
||
Getting Started
|
||
---------------
|
||
|
||
This sample uses the Gradle build system.
|
||
|
||
First download the samples by cloning this repository or downloading an archived
|
||
snapshot. (See the options at the top of the page.)
|
||
|
||
In Android Studio, use "Open an existing Android Studio project". Next select the `ApiDemos/kotlin/` directory that you downloaded
|
||
from this repository.
|
||
If prompted for a gradle configuration accept the default settings.
|
||
|
||
Alternatively use the `gradlew build` command to build the project directly.
|
||
|
||
This demo app requires that you add your own Google Maps API key:
|
||
|
||
1. [Get a Maps API key](https://developers.google.com/maps/documentation/android-sdk/get-api-key)
|
||
1. Create a file in the root directory called `secure.properties` (this file should *NOT* be under version control to protect your API key)
|
||
1. Add a single line to `secure.properties` that looks like `MAPS_API_KEY=YOUR_API_KEY`, where `YOUR_API_KEY` is the API key you obtained in the first step
|
||
1. Build and run
|
||
|
||
Support
|
||
-------
|
||
|
||
- Stack Overflow: https://stackoverflow.com/questions/tagged/android+google-maps
|
||
|
||
If you have discovered an issue with the Google Maps Android API v2, please see
|
||
the resources here: https://developers.google.com/maps/documentation/android-api/support
|
||
|
||
If you've found an error in these samples, please file an issue:
|
||
https://github.com/googlemaps/android-samples/issues
|
||
|
||
Patches are encouraged, and may be submitted according to the instructions in
|
||
CONTRIBUTING.md.
|
||
|
||
|
||
|
||
License
|
||
-------
|
||
|
||
Please refer to the [LICENSE](https://github.com/googlemaps/android-samples/blob/master/LICENSE) at the root of this repo.
|