alexantr/yii2-coordinates-input

Map coordinates input widget for Yii 2

Map coordinates input widget for Yii 2

This extension renders an input with Google map or Yandex map and allows to set coordinates quickly by clicking on the map., _(*1)

, _(*2)

Installation

Install extension through composer:, _(*3)

composer require alexantr/yii2-coordinates-input

Configuring

At first set Google Maps API key in application config. Additionally you can set Yandex Maps language and initial coordinates for all maps., _(*4)

[
    'components' => [
        'assetManager' => [
            'bundles' => [
                'alexantr\coordinates\CoordinatesAsset' => [
                    'googleMapsApiKey' => 'UBcsRlxWxBjmZBvrW154fXJ4eJeeO4TFMp9pRLi', // <- put api key here
                    'yandexMapsLang' => 'en_US',
                    'initialCoordinates' => [-53.106392, 73.528748], // [latitude, longitude]
                    'initialZoom' => 8, // Default is 10
                ],
            ],
        ],
    ],
]

Usage

The following code in a view file would render an input with Google map:, _(*5)

<?= alexantr\coordinates\CoordinatesInput::widget(['name' => 'attributeName']) ?>

If you want to use this input widget in an ActiveForm, it can be done like this:, _(*6)

<?= $form->field($model, 'attributeName')->widget(alexantr\coordinates\CoordinatesInput::className(), ['yandexMaps' => true]) ?>

All widget options with default values:, _(*7)

<?= alexantr\coordinates\CoordinatesInput::widget([
    'name' => 'attributeName',
    // there is
    'options' => ['class' => 'form-control coordinates-input'],
    'mapOptions' => ['class' => 'coordinates-map-container'],
    'initialCoordinates' => null,
    'initialZoom' => null,
    'yandexMaps' => false, // Set to true to use Yandex maps instead Google maps
]) ?>

Value of initialCoordinates can be in two formats: [53.923172, 27.540036] or ['lat' => 53.923172, 'lng' => 27.540036]., _(*8)