# Mapzen Places API Sample Application

## Get Mapzen API Key
Before using the sample app, sign up for a Mapzen API key on the [Mapzen developer portal](https://mapzen.com/developers).

## Add Mapzen API Key to mapzen.xml
Replace the dummy text value of `mapzen_api_key` with your API key in [mapzen.xml](https://github.com/mapzen/android/blob/master/samples/mapzen-places-api-sample/src/main/res/values/mapzen.xml).

## Install App
`git submodule init`

`git submodule update`

`./gradlew installDebug`

# Mapzen Places API Sample Application

The Mapzen Places API sample application provides a working a example of the primary features of the API including the Place Picker widget and Autocomplete widget.

## Get a Mapzen API key
Before using the sample app, sign up for a Mapzen API key on the [Mapzen developer portal](https://mapzen.com/developers).

## Add your Mapzen API key to mapzen.xml
Add your Mapzen API key to the sample app by replacing the dummy text value of `mapzen_api_key` with your API key in [mapzen.xml](https://github.com/mapzen/android/blob/master/samples/mapzen-places-api-sample/src/main/res/values/mapzen.xml).

```xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
  <string name="mapzen_api_key">[YOUR_MAPZEN_API_KEY]</string>
</resources>
```

## Build and install

Run the following commands from the root folder of the project to build and install the app.

```bash
git submodule init
git submodule update
./gradlew installPlacesDemo
```

Update Places API sample app instructions
Update Places API sample app instructions