<commit_before># Mapzen Android SDK
[![Circle CI](https://circleci.com/gh/mapzen/android.svg?style=svg&circle-token=<PASSWORD>)](https://circleci.com/gh/mapzen/android)

The Mapzen Android SDK is a thin wrapper that packages up everything you need to use Mapzen services in your Android applications. It also handles API key management, interaction between the components, UI elemets, and assorted other things

## Current functionality:
Currently the Mapzen SDK supports map rendering and location tracking through the following projects:

- [L.O.S.T](https://github.com/mapzen/lost)- Our drop-in replacement for Google Play Services Location APIs
- [Tangram](https://github.com/tangrams/tangram-es/)- Our 2D and 3D map renderer using OpenGL ES

## What's coming up:
We will be incorporating all of Mapzen’s services into the SDK through the following projects:

- [On the road](https://github.com/mapzen/on-the-road)- The Mapzen Turn-by-Turn wrapper and other routing utilities.
- [Pelias](https://github.com/pelias/pelias-android-sdk)- The Mapzen Search wrapper

## Usage

### Getting started

#### 1. Add a map layout

A map can be added to a layout using either `MapView` or `MapFragment`.

```xml
<fragment
    android:id="@+id/map_fragment"
    android:name="com.mapzen.android.MapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />
```

#### 2. Register an API key

Sign up for a vector tiles API key from the [Mapzen developer portal](https://mapzen.com/developers). Add your vector tiles API key to your application as an XML string resource.

```xml
<resources>
    <string name="vector_tiles_key">[YOUR_VECTOR_TILES_KEY]</string>
</resources>
```

#### 3. Initialize the map

Initialize the map using `getMapAsync(MapView.OnMapReadyCallback)`.

```java
mapFragment = (MapFragment) getSupportFragmentManager().findFragmentById(R.id.fragment);
mapFragment.getMapAsync(new MapView.OnMapReadyCallback() {
  @Override public void onMapReady(MapController mapController) {
    // Map is ready.
  }
});
```

Your map is now ready to use. `MapContoller` is your main entry point to interact with the map. See below for some common use cases like adding a marker or drawing a line.

For advanced use (animations, custom styles, etc.) please refer to the [Tangram ES](https://github.com/tangrams/tangram-es) documentation.

### Set position, rotation, and zoom level

Coming soon.

### Current location

Coming soon.

### Markers

Coming soon.

### Polylines

Coming soon.

## Install

### Download

Download the [latest AAR](https://oss.sonatype.org/content/repositories/snapshots/com/mapzen/mapzen-android-sdk/0.1.0-SNAPSHOT/).

### Maven

Include dependency using Maven.

```xml
<dependency>
  <groupId>com.mapzen</groupId>
  <artifactId>mapzen-android-sdk</artifactId>
  <version>0.1.0-SNAPSHOT</version>
</dependency>
```

### Gradle

Include dependency using Gradle.

```groovy
compile 'com.mapzen:mapzen-android-sdk:0.1.0-SNAPSHOT'
```
<commit_msg>Moving an H<commit_after># Mapzen Android SDK
[![Circle CI](https://circleci.com/gh/mapzen/android.svg?style=svg&circle-token=<PASSWORD>)](https://circleci.com/gh/mapzen/android)

The Mapzen Android SDK is a thin wrapper that packages up everything you need to use Mapzen services in your Android applications. It also handles API key management, interaction between the components, UI elemets, and assorted other things

## Current functionality:
Currently the Mapzen SDK supports map rendering and location tracking through the following projects:

- [L.O.S.T](https://github.com/mapzen/lost)- Our drop-in replacement for Google Play Services Location APIs
- [Tangram](https://github.com/tangrams/tangram-es/)- Our 2D and 3D map renderer using OpenGL ES

## What's coming up:
We will be incorporating all of Mapzen’s services into the SDK through the following projects:

- [On the road](https://github.com/mapzen/on-the-road)- The Mapzen Turn-by-Turn wrapper and other routing utilities.
- [Pelias](https://github.com/pelias/pelias-android-sdk)- The Mapzen Search wrapper

# Usage

## Getting started

### 1. Add a map layout

A map can be added to a layout using either `MapView` or `MapFragment`.

```xml
<fragment
    android:id="@+id/map_fragment"
    android:name="com.mapzen.android.MapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />
```

### 2. Register an API key

Sign up for a vector tiles API key from the [Mapzen developer portal](https://mapzen.com/developers). Add your vector tiles API key to your application as an XML string resource.

```xml
<resources>
    <string name="vector_tiles_key">[YOUR_VECTOR_TILES_KEY]</string>
</resources>
```

### 3. Initialize the map

Initialize the map using `getMapAsync(MapView.OnMapReadyCallback)`.

```java
mapFragment = (MapFragment) getSupportFragmentManager().findFragmentById(R.id.fragment);
mapFragment.getMapAsync(new MapView.OnMapReadyCallback() {
  @Override public void onMapReady(MapController mapController) {
    // Map is ready.
  }
});
```

Your map is now ready to use. `MapContoller` is your main entry point to interact with the map. See below for some common use cases like adding a marker or drawing a line.

For advanced use (animations, custom styles, etc.) please refer to the [Tangram ES](https://github.com/tangrams/tangram-es) documentation.

## Set position, rotation, and zoom level

Coming soon.

## Current location

Coming soon.

## Markers

Coming soon.

## Polylines

Coming soon.

# Install

## Download

Download the [latest AAR](https://oss.sonatype.org/content/repositories/snapshots/com/mapzen/mapzen-android-sdk/0.1.0-SNAPSHOT/).

## Maven

Include dependency using Maven.

```xml
<dependency>
  <groupId>com.mapzen</groupId>
  <artifactId>mapzen-android-sdk</artifactId>
  <version>0.1.0-SNAPSHOT</version>
</dependency>
```

## Gradle

Include dependency using Gradle.

```groovy
compile 'com.mapzen:mapzen-android-sdk:0.1.0-SNAPSHOT'
```

{'fraction_non_alphanumeric': 0.11883670399465152, 'fraction_numerical': 0.004679926458298512, 'mean_word_length': 4.68281101614435, 'pattern_counts': {'":': 0, '<': 31, '<?xml version=': 0, '>': 31, 'https://': 18, 'lorem ipsum': 0, 'www.': 0, 'xml': 6}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2780385', 'n_tokens_mistral': 1908, 'n_tokens_neox': 1822, 'n_words': 584}