search.md

Search

Getting Started

To start using Mapzen Search in your apps, you need a Mapzen API key. After you sign up for an API key you will need to include it in your application through the Java API or in a mapzen.xml properties file in your app resources folder.

MySearchActivity.java

public class MySearchActivity extends Activity {
  @Override protected void onCreate(Bundle icicle) {
    MapzenSearch mapzenSearch = new MapzenSearch(this, “your-mapzen-api-key”);
    ...
  }

mapzen.xml

<resources>
  <string name="mapzen_api_key">your-mapzen-api-key</string>
</resources>

Search

Find a place by searching for an address or name.

mapzenSearch.search("coffee", 40.7443, -73.9903, new Callback<Result>() {
  @Override public void success(Result result, Response response) {
    // Display search results
  }

  @Override public void failure(RetrofitError error) {
    // Oh no
  }
});

Autocomplete

Get real-time result suggestions without having to type the whole location.

mapzenSearch.suggest("cof", 40.7443, -73.9903, new Callback<Result>() {
  @Override public void success(Result result, Response response) {
    // Display autocomplete results
  }

  @Override public void failure(RetrofitError error) {
    // Oh no
  }
});

Reverse

Find what is located at a certain coordinate location.

mapzenSearch.reverse(40.7443, -73.9903, new Callback<Result>() {
  @Override public void success(Result result, Response response) {
    // Display reverse geocode results
  }

  @Override public void failure(RetrofitError error) {
    // Oh no
  }
});

PeliasSearchView

The Mapzen Android SDK has its own custom extension of SearchView that is integrated with autocomplete and search. Just drop an instance of PeliasSearchView into your layout and provide it with an AutoCompleteListView to display the results.

// Configure search view
PeliasSearchView peliasSearchView = new PeliasSearchView(this);
ActionBar.LayoutParams layoutParams = new ActionBar.LayoutParams(
    ActionBar.LayoutParams.MATCH_PARENT, ActionBar.LayoutParams.MATCH_PARENT);
getSupportActionBar().setCustomView(peliasSearchView, layoutParams);
getSupportActionBar().setDisplayOptions(ActionBar.DISPLAY_SHOW_CUSTOM);

// Configure autocomplete listview
AutoCompleteListView  listView = (AutoCompleteListView)
    findViewById(R.id.list_view);
AutoCompleteAdapter adapter = new AutoCompleteAdapter(this,
    android.R.layout.simple_list_item_1);
listView.setAdapter(autocompleteAdapter);

// Configure search service
MapzenSearch mapzenSearch = new MapzenSearch(this, “your-mapzen-api-key”);

// Tying it all together
peliasSearchView.setAutoCompleteListView(listView);
peliasSearchView.setPelias(mapzenSearch);
peliasSearchView.setCallback(new Callback<Result>() {
  @Override public void success(Result result, Response response) {
    // Draw some pins on the map...
  }

  @Override public void failure(RetrofitError error) {
    // Uh oh
  }
});