kl83/yii2-ymaps

Yii2 Yandex Maps toolkit

dev-master 2019-02-07 13:18 UTC

Requires

• yiisoft/yii2: ^2.0.0
• yiisoft/yii2-jui: ^2.0

MIT

• Aleksandr Solovyov

README

Widgets list:

• CoordsInput: selection of coordinates on the map;
• StreetInput: jui autocomplete with street names of specified city;
• MapWidget: displays the Yandex map and the placemarks.

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require kl83/yii2-ymaps @dev

or add

"kl83/yii2-ymaps": "@dev"

to the require section of your composer.json file.

Usage

CoordsInput

<?= $form->field($model, 'coords')->widget('kl83\ymaps\CoordsInput', [
  'options' => [], // Html-attributes of container
  'ymapsClientOptions' => [], // Yandex map JS settings
  'placemarkClientProperties' => [], // Placemark JS properties
  'placemarkClientOptions' => [], // Placemark JS options
]) ?>

StreetInput

<?= $form->field($model, 'street')->widget('kl83\ymaps\StreetInput', [
  'options' => [], // Html-attributes
  'city' => '', // Search streets in specified city
]) ?>

MapWidget

<?= MapWidget::widget([
    'mapState' => [
        'center' => [55.76, 37.64],
        'zoom' => 16,
    ],
    'placemarks' => [
        [
            [55.76, 37.64],
            [], // properties
            [], // options
        ],
        [
            [55.76, 37.64],
        ],
    ],
]) ?>

Interactivity

CoordsInput

Finds the specified address on the map, and moves the placemark to it.

$('.widget').coordsInput('search', 'Some address');

StreetInput

Get or set the city to search on.

$('.widget').streetInput('city'); // Get
$('.widget').streetInput('city', 'Some city'); // Set

License

MIT License