salutesaab / nearby-android

ArcGIS Android app to find places nearby and route to the nearest location.

Nearby-Places Android

This repo provides an example app called Nearby Places for Android devices built with the ArcGIS Runtime SDK for Android. With some minor customization, you can change the types of places displayed or simply use the app as is.

Visit Esri's example app site to read more about this app and how the Runtime features are implemented. Join our GeoNet community and keep up to date on the latest discussions about example-apps!

Features

• Geocoding with categories
• Device location
• Calculating bearing and distance

Development Instructions

This Nearby-Places repo is an Android Studio Project and App Module that can be directly cloned and imported into Android Studio.

Fork the repo

Fork the Nearby Places Android repo.

Clone the repo

Once you have forked the repo, you can make a clone

Command line Git

1. Clone the Nearby Places repo
2. cd into the nearby-android folder
3. Make your changes and create a pull request

Configuring a Remote for a Fork

If you make changes in the fork and would like to sync those changes with the upstream repository, you must first configure the remote. This will be required when you have created local branches and would like to make a pull request to your upstream branch.

1. In the Terminal (for Mac users) or command prompt (fow Windows and Linux users) type git remote -v to list the current configured remote repo for your fork.
2. git remote add upstream https://github.com/Esri/nearby-android.git to specify new remote upstream repository that will be synced with the fork. You can type git remote -v to verify the new upstream.

If there are changes made in the Original repository, you can sync the fork to keep it updated with upstream repository.

1. In the terminal, change the current working directory to your local project
2. Type git fetch upstream to fetch the commits from the upstream repository
3. git checkout master to checkout your fork's local master branch.
4. git merge upstream/master to sync your local master' branch with upstream/master`. Note: Your local changes will be retained and your fork's master branch will be in sync with the upstream repository.

Requirements

• JDK 6 or higher
• Android Studio

Resources

• Nearby Places
• ArcGIS Runtime SDK for Android Developers Site
• ArcGIS Mobile Blog
• ArcGIS Developer Blog
• Google+
• twitter@ArcGISRuntime
• twitter@esri

Issues

Find a bug or want to request a new feature enhancement? Let us know by submitting an issue.

Contributing

Anyone and everyone is welcome to contribute. We do accept pull requests.

1. Get involved
2. Report issues
3. Contribute code
4. Improve documentation

Licensing

Copyright 2017 Esri

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

A copy of the license is available in the repository's LICENSE file.

For information about licensing your deployed app, see License your app.

[](Esri Tags: ArcGIS Android Mobile) [](Esri Language: Java)​