Skip to content

Commit

Permalink
Added support version 2.1 for yandex map and add some example use it.
Browse files Browse the repository at this point in the history
  • Loading branch information
tulov committed May 30, 2014
1 parent f9d4a74 commit dfc4137
Show file tree
Hide file tree
Showing 113 changed files with 6,669 additions and 270 deletions.
3 changes: 2 additions & 1 deletion Gruntfile.js
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,8 @@ module.exports = function(grunt) {
},
dist: {
files: {
'ya-map.min.js': ['example/ya-map.js']
'ya-map-2.0.min.js': ['example/2.0/ya-map-2.0.js'],
'ya-map-2.1.min.js': ['example/2.1/ya-map-2.1.js']
}
}
}
Expand Down
34 changes: 21 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@ yaMap

**yaMap** Модуль для легкой работы с Яндекс картами в приложениях AngularJS.

Версии Яндекс карт
-----
В настоящий момент поддерживаются 2 версии яндекс карт, 2.0 и 2.1.

Установка
-----
1. Добавьте ссылку на файл ya-map.js в файл вашего главного представления:
Expand All @@ -16,14 +20,14 @@ yaMap
var app = angular.module('myApp', ['yaMap']);
```

3. Задайте предпочитаемый язык и расположение коодинат в массиве, изменив при необходимости значения в yaMapSettings.
3. Задайте предпочитаемый язык и расположение коодинат в массиве, изменив при необходимости значения в `yaMapSettings`. В версии 2.1 `yaMapSettings` является провайдером, и его опции можно устанавливать через `app.config` используя методы `setLanguage`,`setOrder`.
4. Не забудьте установить размеры для контейнера карты, иначе ничего не увидите.

Примеры
-----
Практически все примеры из [песочницы яндекс карт](http://api.yandex.ru/maps/jsbox/) воспроизведены на [демонстрационной странице](http://tulov-alex.ru)
Практически все примеры из [песочницы яндекс карт](http://api.yandex.ru/maps/jsbox/2.1/) воспроизведены на [демонстрационной странице](http://tulov-alex.ru)

В каталоге example содержаться исходные коды примеров. Если вы хотите запустить их на локальном компьютере (все равно требуется подключение к интернет для работы с картами), вам нужно сделать следующее:
В каталоге example содержаться исходные коды примеров, разбитые по версиям API Yandex map. Если вы хотите запустить их на локальном компьютере (все равно требуется подключение к интернет для работы с картами), вам нужно сделать следующее:

1 запустить bower install в корневой папке проекта
2 запустить node web-server.js находясь в папке с примерами.
Expand All @@ -40,14 +44,15 @@ yaMap
Чтобы получить родной объект события используйте `$event`. Получить объект, породивший событие можно через `$event.get('target')`
Соответственно события нужно определять в той директиве, к которой они относятся, например события карты в `yaMap`.

Директива yaMap
Директива yaMap (обе версии)
-----
Представляет карту на вашей странице. Именно в ней должны располагаться практически все остальные директивы.

Атрибуты:

- `ya-center` - выражение, которое должно возвращать массив координат, или строку адреса. Если не задан, тогда определяется текущее местоположение пользователя и используется в качестве центра.
- `ya-zoom` - массштаб карты, по умолчанию 0. Диапазон от 0-23 включительно. 0 самый мелкий (вся земля).
- `ya-controls` - (версия 2.1) задает контролы на карте. Если контролы не нужны `ya-controls=""`. Если не задан, тогда отображаются контролы по умолчанию.
- `ya-type` - тип карты, возможные значения:

yandex#map (схема) - по умолчанию;
Expand All @@ -73,7 +78,7 @@ yaMap
`ya-before-init` - задает функцию, которая будет выполнена после подготовки api карт, но до создания самой карты.
`ya-after-init` - задает функцию, которая будет выполнена после создания объекта карты. Чтобы получить сам объект карты,используйте `$target`.

Директива yaToolbar
Директива yaToolbar (только в версии 2.0)
-----
Представляет набор элементов управления на карте. Обязательно должна находится в yaMap.

Expand All @@ -84,17 +89,17 @@ yaMap
- `ya-params` - параметры создания контрола. по умолчанию не установлены.
- `ya-after-init` - задает функцию, которая будет выполнена после создания объекта. Чтобы получить сам объект,используйте `$target`.

Директива yaControl
Директива yaControl (в обоих версиях)
-----
Представляет элемент управления на карте. Должна стоять внутри `yaToolbar`
Представляет элемент управления на карте. В версии 2.0 должна стоять внутри `yaToolbar`, в 2.1 внутри `yaMap`.

Атрибуты:

- `ya-type` - тип создаваемого элемента управления.
- `ya-params` - параметры элемента управления
- `ya-after-init` - задает функцию, которая будет выполнена после создания объекта. Чтобы получить сам объект,используйте `$target`.

Директива yaCollection
Директива yaCollection (в обоих версиях)
-----
представляет коллекцию гео.объектов. Должна находиться внутри `yaMap`.

Expand All @@ -104,7 +109,7 @@ yaMap
- `ya-show-all` - подстраивать масштаб карты и ее центр при первом отображении, для того чтобы отображались все доступные гео.объекты. По умолчанию: `false`
- `ya-after-init` - задает функцию, которая будет выполнена после создания объекта. Чтобы получить сам объект,используйте `$target`.

Директиа yaGeoObject
Директиа yaGeoObject (в обоих версиях)
-----
представляет гео. объект карты. Должна стоять в `yaMap` или `yaCollection`, или `yaCluster`.

Expand All @@ -117,7 +122,7 @@ yaMap
- `ya-show-balloon` - выражение, если оно возвращает true, то балун будет открыт, иначе закрыт.
- `ya-after-init` - задает функцию, которая будет выполнена после создания объекта. Чтобы получить сам объект,используйте `$target`.

Директива yaImageLayer
Директива yaImageLayer (в обоих версиях)
-----
Представляет собой картиночный слой карты. Должна находиться в yaMap.

Expand All @@ -126,7 +131,7 @@ yaMap
- `ya-url-template` - шаблон URL тайлов картиночного слоя. Обязательный атрибут
- `ya-options` - настройка отображения слоя на карте. Не обязательный атрибут.

Директива yaHotspotLayer
Директива yaHotspotLayer (в обоих версиях)
-----
Представляет собой активный слой карты. Должна находиться в yaMap.

Expand All @@ -136,7 +141,7 @@ yaMap
- `ya-key-template` - Шаблон callback-функции, в которую сервер будет оборачивать данные тайла. Обязательный атрибут.
- `ya-options` - настройки отображения слоя на карте. Не обязательный атрибут.

Директива yaCluster
Директива yaCluster (в обоих версиях)
-----
Представляет кластеризатор карты. Должна находиться в `yaMap`.

Expand All @@ -145,7 +150,7 @@ yaMap
- `ya-options` - задает опции для кластера.
- `ya-after-init` - задает функцию, которая будет выполнена после создания объекта. Чтобы получить сам объект,используйте `$target`.

Директива yaTemplateLayout
Директива yaTemplateLayout (в обоих версиях)
-----
Представляет собой HTML шаблон, который должен использоваться элементами карты. Должна определяться до использования соответствующего шаблона.

Expand All @@ -154,3 +159,6 @@ yaMap
- `ya-key` - ключ для дальнейшего обращения к шаблону
- `ya-overrides` - объект, который задает переопределяемые функции.

Директива yaDragger (в версии 2.1)
-----
Представляет собой перетаскиваемый на карту элемент управления.
Loading

0 comments on commit dfc4137

Please sign in to comment.