Карты в приложении для платформы Android

Здравствуйте!

Существует много способов отображения различной информации на карте в приложении для платформы Android, например, Google Maps или Яндекс Карты, но, пожалуй, самым быстрым и  гибким способом является использование библиотеки osmdroid, т.к. для ее использования не потребуется получения API-ключа, исходный код библиотеки открыт, есть возможность отображать карты из различных источников (например, OpenStreetMap и др.), добавлять новые без существенной доработки исходного кода библиотеки или вовсе без доработки. Загруженные карты сохраняются на карте памяти и доступны без подключения к сети Internet.

В этой заметке, рассмотрим:

1. Добавление библиотеки в проект (Eclipse, Windows)
2. Размещение карты в разметке
3. Добавление нового источника карт
4. Переключение между поставщиками карт, изменение масштаба, центра карты
5. Вывод информации на карту

1. Добавление библиотеки в проект (Eclipse, Windows)
Скачаем основную библиотеку и вспомогательную, которая требуется для работы основной и добавим их в наш проект.

В манифест добавим разрешения для нашего приложения
"android.permission.INTERNET" 
"android.permission.WRITE_EXTERNAL_STORAGE" "android.permission.ACCESS_COARSE_LOCATION" "android.permission.ACCESS_FINE_LOCATION" "android.permission.ACCESS_NETWORK_STATE"
"android.permission.ACCESS_WIFI_STATE" 

2. Размещение карты в разметке
Разметка нашей Activity с картой будет динамической, т.е. создадим ее в процессе выполнения приложения в методе onCreate

private MapView mMap;
@Override
public void onCreate(Bundle savedInstanceState) {
 super.onCreate(savedInstanceState);
 final RelativeLayout rl = new RelativeLayout(this); // разметка
 mMap = new MapView(this, 256); // наша карта

 //разрешаем встроенные кнопки изменения масштаба

 mMap.setBuiltInZoomControls(true);
 // добавим карту в разметку
 rl.addView( mMap, new RelativeLayout.LayoutParams(LayoutParams.FILL_PARENT,
   LayoutParams.FILL_PARENT));
 setContentView(rl);
}

3. Добавление нового источника карт

Чтобы добавить новый источник создадим новый класс наследник XYTileSource и добавим в наш пакет.

public class myNoYandexTileSource extends XYTileSource{

 public myNoYandexTileSource(String aName, string aResourceId,
   int aZoomMinLevel, int aZoomMaxLevel, int aTileSizePixels,
   String aImageFilenameEnding, String... aBaseUrl) {
  super(aName, aResourceId, aZoomMinLevel, aZoomMaxLevel, aTileSizePixels,
    aImageFilenameEnding, aBaseUrl);
  // TODO Auto-generated constructor stub
 }

 @Override
 public String getTileURLString(MapTile aTile) {
  // TODO Auto-generated method stub
  return String.format(getBaseUrl(), aTile.getX(), aTile.getY(), aTile.getZoomLevel());
 }

}

И создадим экземпляры этого класса

 //Google Maps

final ITileSource tileSourceGoogleMap=new myNoYandexTileSource("Google-Map", null, 0, 23, 256, ".png",

  "http://mt0.google.com/vt/lyrs=m&hl=ru&x=%s&y=%s&z=%s&s=Galileo",

  "http://mt1.google.com/vt/lyrs=m&hl=ru&x=%s&y=%s&z=%s&s=Galileo",

  "http://mt2.google.com/vt/lyrs=m&hl=ru&x=%s&y=%s&z=%s&s=Galileo",

  "http://mt3.google.com/vt/lyrs=m&hl=ru&x=%s&y=%s&z=%s&s=Galileo");   

mTileSources.add(tileSourceGoogleMap);

/Google Maps Sat

final ITileSource tileSourceGoogleSat=new myNoYandexTileSource("Google-Sat", null, 0, 23, 256, ".png",

  "http://khm0.google.ru/kh/v=95&x=%s&y=%s&z=%s&s=Galileo",

  "http://khm1.google.ru/kh/v=95&x=%s&y=%s&z=%s&s=Galileo",

   "http://khm2.google.ru/kh/v=95&x=%s&y=%s&z=%s&s=Galileo",

   "http://khm3.google.ru/kh/v=95&x=%s&y=%s&z=%s&s=Galileo");

4. Переключение между поставщиками карт, изменение масштаба, центра карты
Отображать Google Maps Карты

mMap.setTileSource(tileSourceGoogleMap);

Отображать Google Maps Спутник

mMap.setTileSource(tileSourceGoogleSat);

Отображать OpenStreetMap

mMap.setTileSource(TileSourceFactory.MAPNIK);

Изменение масштаба

mMap.getController().setZoom(10);

Перемещение центра карты

GeoPoint p = new GeoPoint(55.786438, 49.122458);
mMap.getController().animateTo(p);

5. Вывод информации на карту

final ArrayList items = new ArrayList(); 
items.add(new OverlayItem("Казань", "Татарстан", new GeoPoint(55.786438, 49.122458)));
ItemizedIconOverlay MyLocationOverlay = new ItemizedIconOverlay(this, items, null);          
mMap.getOverlays().add(MyLocationOverlay);

Замечу, что Яндекс Карты добавленные описанным способом будут отображаться неверно из-за того, что библиотека не поддерживает нужной проекции. В следующих заметках постараюсь описать, как это исправить без изменения кода библиотеки и доработав код.