Android Google Maps Api v2. Урок 4. Строим маршрут на карте

Итак, продолжаем нашу серию спонтанных уроков, вызванных необходимостью переводить своё приложение на новый API
Сегодня мы разберемся, как получить маршрут и отобразить его на карте. Для этого обратимся к API Google Directions.

Получать маршрут мы будем грамотно, используя AsyncTask. Мы должны обратиться к Google Service Directions, передать координаты начальной и конечной точек и распарсить JSON ответ. Например вот такой: http://maps.google.com/maps/api/directions/json?origin=55.772851,37.586806&destination=55.415003,37.899904&sensor=false

При этом мы в ответе мы получаем шифрованную полилайн для каждого шага, я написал метод decodePolilyne. Можно конечно ограничиться начальными и конечными координатами шага, но полученный результат вас не устроит, проверено на себе.

Итак, пишем интерфейс для AsyncTask, сохраняем его в файл OnRouteCalcCompleted.java:

package com.example.mapexample;

import java.util.ArrayList;

import com.google.android.gms.maps.model.LatLng;

public interface OnRouteCalcCompleted{
    void onRouteCalcBegin();
    void onRouteCompleted( ArrayList route );
}

И саму AsyncTask RouteHandler.java:


package com.example.mapexample;

import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
import org.apache.http.client.ClientProtocolException;
import org.apache.http.client.HttpClient;
import org.apache.http.client.ResponseHandler;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.BasicResponseHandler;
import org.apache.http.impl.client.DefaultHttpClient;
import org.json.JSONArray;
import org.json.JSONException;
import org.json.JSONObject;

import com.google.android.gms.maps.model.LatLng;

import android.os.AsyncTask;
import android.util.Log;


/**
 * Класс возвращает полилинию дороги, если указан mapView, отрисовывается на нём
 * @author awacs
 *
 */
public class RouteHandler extends AsyncTask {
   
    private final static String TAG = "RouteHandler";
    
    /**
     * Для точного интерполирования марштура
     */
    public static final int FINE_ROUTE = 1;
   
    /**
     * Для грубого интерполирования маршрута
     */
    public static final int COARSE_ROUTE = 2;    
 
    private final HttpClient client = new DefaultHttpClient();
    private String content;
    private boolean error = false;
    private String error_msg = "";
   
    private ArrayList polyline;
   
    private int accuracyRoute = 1;
   
    private long distance;
   
    private OnRouteCalcCompleted listener;
   
    public RouteHandler( OnRouteCalcCompleted l ){
        this.listener = l;
    }
   
    public double getDistance(){
        Log.d(TAG, "distance = " + distance + "m");
        return distance/1000;
    }
   
    public void calculateRoute( double latStart, double lonStart, double latEnd, double lonEnd, int accuracy ){
       
        this.accuracyRoute = accuracy;
       
        StringBuilder origin = new StringBuilder();
        origin.append( Double.toString(latStart));
        origin.append(",");
        origin.append( Double.toString(lonStart));       

        StringBuilder destination = new StringBuilder();
        destination.append( Double.toString(latEnd));
        destination.append(",");
        destination.append( Double.toString(lonEnd));       
       
        List nameValuePairs = new ArrayList();
        nameValuePairs.add(new BasicNameValuePair("origin", origin.toString()));
        nameValuePairs.add(new BasicNameValuePair("destination", destination.toString() ));
        nameValuePairs.add(new BasicNameValuePair("sensor", "false"));
        String paramString = URLEncodedUtils.format(nameValuePairs, "utf-8");
        execute( "http://maps.google.com/maps/api/directions/json" + "?" + paramString );
 
    }
   

    public boolean isError(){
        return error;
    }
   
    public String getErrorMsg(){
        return error_msg;
    }
   
    @Override
    protected String doInBackground(String... urls) {
       
        Log.d(TAG, "RouteHandler::doInBackground");

        try {
            Log.v(TAG, urls[0]);
            HttpPost httppost = new HttpPost(urls[0]);
            ResponseHandler responseHandler = new BasicResponseHandler();
            content = client.execute( httppost, responseHandler );
        } catch (ClientProtocolException e) {
            Log.d(TAG, "GetRouteHandler::ClientProtocolException");
            e.printStackTrace();
            error = true;
            cancel(true);
         } catch (IOException e) {
            Log.d(TAG, "GetRouteHandler::IOException");
            e.printStackTrace();
            error = true;
            cancel(true);
         }
        return content;
    }
   
    protected void onPostExecute(String content) {
        if (error) {
            error_msg = "Offline";
        } else {
            try {
                JSONObject response = new JSONObject(content);
                String status = response.getString("status");
                Log.v(TAG, content);
                if( status.equalsIgnoreCase("OK") ){
                    polyline = new ArrayList();
               
                    JSONArray routesArray = response.getJSONArray("routes");
                    JSONObject route = routesArray.getJSONObject(0);
                    // массив с информацией об отрезке маршрута
                    JSONArray legs = route.getJSONArray("legs");
                    JSONObject leg = legs.getJSONObject(0);   
                   
                    JSONObject distanceObj = leg.getJSONObject("distance");
                    distance = distanceObj.getLong("value");
                   
                    JSONObject durationObj = leg.getJSONObject("duration");
                   
                    // содержит куб выделения информационного окна для маршрута.
                    JSONObject bounds = route.getJSONObject("bounds");
                    JSONObject bounds_southwest = bounds.getJSONObject("southwest");
                    JSONObject bounds_northeast = bounds.getJSONObject("northeast");
                   
                    double maxLat = bounds_northeast.getDouble("lat");
                    double maxLon = bounds_northeast.getDouble("lng");
                    double minLat = bounds_southwest.getDouble("lat");
                    double minLon = bounds_southwest.getDouble("lng");
           

                    JSONArray steps = leg.getJSONArray("steps");
                    for( int i=0; i
                        JSONObject step = steps.getJSONObject(i);
                        JSONObject start_location = step.getJSONObject("start_location");
                        JSONObject end_location = step.getJSONObject("end_location");

                        double latitudeStart = start_location.getDouble("lat");
                        double longitudeStart = start_location.getDouble("lng");
                        double latitudeEnd = end_location.getDouble("lat");
                        double longitudeEnd = end_location.getDouble("lng");
                        LatLng startGeoPoint = new LatLng(latitudeStart,longitudeStart);
                        LatLng endGeoPoint = new LatLng(latitudeEnd,longitudeEnd);
                        JSONObject polylineObject = step.getJSONObject("polyline");
                        if( accuracyRoute == FINE_ROUTE ){
                            List points = decodePoly(polylineObject.getString("points"));
                            Log.d(TAG, " " + points.size());
                            polyline.addAll(points);
                        } else {
                            polyline.add(startGeoPoint);
                            polyline.add(endGeoPoint);
                        }
                    }

                } else if( status.equalsIgnoreCase("NOT_FOUND")){
                    // по крайней мере для одной заданной точки (исходной точки, пункта назначения или путевой точки) геокодирование невозможно.
                } else if( status.equalsIgnoreCase("ZERO_RESULTS")){
                    // между исходной точкой и пунктом назначения не найдено ни одного маршрута.
                } else if( status.equalsIgnoreCase("MAX_WAYPOINTS_EXCEEDED")){
                    // в запросе задано слишком много waypoints. Максимальное количество waypoints равно 8 плюс исходная точка и пункт назначения. ( (Пользователи Google Maps Premier могут выполнять запросы с количеством путевых точек до 23.)
                } else if( status.equalsIgnoreCase("INVALID_REQUEST")){
                    // запрос недопустим
                }else if( status.equalsIgnoreCase("OVER_QUERY_LIMIT")){
                    // служба получила слишком много запросов от вашего приложения в разрешенный период времени.
                }else if( status.equalsIgnoreCase("REQUEST_DENIED")){
                    // служба Directions отклонила запрос вашего приложения.
                }else if( status.equalsIgnoreCase("UNKNOWN_ERROR")){
                    // обработка запроса маршрута невозможна из-за ошибки сервера. При повторной попытке запрос может быть успешно выполнен
                }
            } catch (JSONException e) {
                e.printStackTrace();
            }
        }
       
        listener.onRouteCompleted( polyline );
       
    } // end postExecute
   
    /**
     * Декодирует полилинию из переданной гуглом строки
     * @param encoded
     * @return
     */
    private List decodePoly(String encoded) {

        List poly = new ArrayList();
        int index = 0, len = encoded.length();
        int lat = 0, lng = 0;

        while (index < len) {
            int b, shift = 0, result = 0;
            do {
                b = encoded.charAt(index++) - 63;
                result |= (b & 0x1f) << shift;
                shift += 5;
            } while (b >= 0x20);
            int dlat = ((result & 1) != 0 ? ~(result >> 1) : (result >> 1));
            lat += dlat;

            shift = 0;
            result = 0;
            do {
                b = encoded.charAt(index++) - 63;
                result |= (b & 0x1f) << shift;
                shift += 5;
            } while (b >= 0x20);
            int dlng = ((result & 1) != 0 ? ~(result >> 1) : (result >> 1));
            lng += dlng;

            LatLng p = new LatLng( lat/1E5, lng/1E5);
            poly.add(p);
        }

        return poly;
    } // end decodePoly      
   
} // end class

Для использования этого таска в нашей активити, нужно имплементить OnRouteCalcCompleted, соответвенно в Activity добавятся методы:

    @Override
    public void onRouteCalcBegin() {
        // Тут можно добавить например вызов прогрессбара, "Ждите, строим маршрут...."
    }

а отобразить готовую полилинию можно в добавленном onRouteCompleted:

    @Override
    public void onRouteCompleted(ArrayList route) {

        mMap.addPolyline((new PolylineOptions().color(Color.BLUE).width(5)).addAll(route));

        // а заодно и удалить прогрессбар :)
    }

Да, теперь добавляем например в инициализацию mMap из урока 3 код для вызова AsyncTask и компилируем готовое приложение.

        private RouteHandler routeHandler;

    private void setUpMapIfNeeded() {
        if (mMap == null) {
            mMap = ((SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.mapView)).getMap();
        }
        routeHandler = new RouteHandler( this );
        routeHandler.calculateRoute(55.772935, 37.594272, 55.88459, 37.4263165, RouteHandler.FINE_ROUTE);       
    }

Код полной активити:

package com.example.mapexample;

import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.GoogleMap.OnMapLongClickListener;
import com.google.android.gms.maps.LocationSource;
import com.google.android.gms.maps.SupportMapFragment;
import com.google.android.gms.maps.model.BitmapDescriptorFactory;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.MarkerOptions;
import com.google.android.gms.maps.model.PolylineOptions;

import java.sql.Time;
import java.util.ArrayList;

import android.graphics.Color;
import android.location.Criteria;
import android.location.Location;
import android.location.LocationListener;
import android.location.LocationManager;
import android.os.Bundle;
import android.support.v4.app.FragmentActivity;
import android.util.Log;


public class MainActivity extends FragmentActivity implements LocationSource, LocationListener, OnRouteCalcCompleted{
   
    private final static String TAG = "MainActivity";

    private OnLocationChangedListener mListener;
    private LocationManager lManager;
   
    private GoogleMap mMap;
   
    private static double mLatitude;
    private static double mLongitude;   
   
    private RouteHandler routeHandler;
   
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mMap = ((SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.mapView)).getMap();
        //mMap.setTrafficEnabled(true);
        mMap.setMyLocationEnabled(true);
        mMap.setOnMapLongClickListener(this);
        lManager = (LocationManager) getSystemService(LOCATION_SERVICE);
        lManager.requestLocationUpdates( lManager.getBestProvider(new Criteria(), true), 1, 1000, this);       
        setUpMapIfNeeded();
    }
   
    @Override
    protected void onResume() {
        super.onResume();
        setUpMapIfNeeded();
        if( lManager != null ){
            lManager.requestLocationUpdates(lManager.getBestProvider(new Criteria(), true), 1, 1000, this);
        }       
    }
   
    private void setUpMapIfNeeded() {
        if (mMap == null) {
            mMap = ((SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.mapView)).getMap();
        }
        routeHandler = new RouteHandler( this );
        routeHandler.calculateRoute(55.772935, 37.594272, 55.88459, 37.4263165, AppSettings.FINE_ROUTE);       
    }


     protected void onPause() {
         if( lManager != null ){
             lManager.removeUpdates(this);
         }
         super.onPause();
     }   
   



    @Override
    public void onLocationChanged(Location location) {
        if( mListener != null ){
            mListener.onLocationChanged( location );
        }
    }

    @Override
    public void activate(OnLocationChangedListener listener) {
        mListener = listener;
       
    }

    @Override
    public void deactivate() {
        mListener = null;
    }

    @Override
    public void onProviderDisabled(String provider) {
        // TODO Auto-generated method stub
       
    }

    @Override
    public void onProviderEnabled(String provider) {
        // TODO Auto-generated method stub
       
    }

    @Override
    public void onStatusChanged(String provider, int status, Bundle extras) {
        // TODO Auto-generated method stub
       
    }

    @Override
    public void onRouteCalcBegin() {
        // TODO Auto-generated method stub
       
    }

    @Override
    public void onRouteCompleted(ArrayList route) {
        mMap.addPolyline((new PolylineOptions().color(Color.BLUE).width(5)).addAll(route));
    }

}

Android Google Maps API v2. Урок 2. Отображение карты

Итак, в первом уроке мы получили ключ разработчика и сейчас хотим его использовать по назначению.

1. Скачиваем необходимые библиотеки

Первым делом необходимо скачать и установить Google Play SDK и Android Support Library, сделать это можно из Eclipse. Для этого заходим в меню Window - Android SDK Manager, внизу находим Extras - Google Play Services и Extras - Android Support Library, жмем чекбокс и кнопку Install Packages.

Пакеты устанавливаются...

Устанавливаются...

Установились.

2. Добавляем библиотеки в Eclipse.

Необходимо в Eclipse добавить эти экстрасы. Правой кнопкой в Package Explorer. Import. Android - Existing Android Code Into Workspace. Выбираем директорию, в которой был установлен Android SDK, далее в ней папку Extras, и далее:
а) android - support - v4. Finish
б) google - google_play_services - libproject - google-play-services_lib. Finish

3. Создаем новый проект в Eclipse

Как создать проект я думаю все знают. А кто не знает - найдет кучу инструкций по Android Hello World. После создания проекта подключаем к нему библиотеки. Правой кнопкой по проекту в Package Explorer. Properties. Android. Видим вкладку Library и кнопку Add. Добавляем скаченные и импортнутые библиотеки.
Заодно проверяем версию проекта, она должна быть не ниже 2.2!

4. Правим Android Manifest

Добавляем необходимые разрешения. Здесь они немного избыточные, но это нам пригодится в будущем:

 
Здесь нужно подставить название своего пакета


В секции (!!!) добавляем свой API ключ:

И собственно всё

5. Правим Activity
Вместо Activity в секцию extends пишем FragmentActivity

6. Правим Layout
В layout нашей активити пишем:

Собираем приложение и проверяем. Желательно на устройстве, нормальной работы интернета на эмуляторе лично я не получил.

Android Google Maps API v2. Урок 1. Получаем код API

Итак, чтобы писать приложения Android, использующие карты Google необходимо обзавестись API ключом. Для этого:

1. Заходим на консоль Google API Console и авторизуемся. Естественно, аккаунт на один из сервисов Google у вас уже должен быть
2. Для нас уже будет создан проект под названием API Project. Но можно создать и свой (нажать на кнопку API Project сверху слева, выбрать из меню пункт Create, ввести имя проекта)
3. Выбираем в левом меню пункт Services, получаем список сервисов которые можно подключить к проекту. Ищем в списке Google Maps Android API v2. Переводим переключатель в значение ВКЛ. 

В меню слева выбрать пункт API access (Доступ к API). Ваш ключ указан на этой странице.

Этот ключ необходимо скопировать в ваш Android Manifest. Куда именно - будет рассказано в следующем уроке