https://github.com/alexantr/yii2-coordinates-input

Map coordinates input widget for Yii 2
https://github.com/alexantr/yii2-coordinates-input

coordinates google-maps maps widget yandex-maps yii2-extension

Last synced: 3 months ago
JSON representation

Map coordinates input widget for Yii 2

• Host: GitHub
• URL: https://github.com/alexantr/yii2-coordinates-input
• Owner: alexantr
• License: mit
• Archived: true
• Created: 2018-01-22T19:26:12.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2018-02-19T20:34:41.000Z (almost 7 years ago)
• Last Synced: 2024-08-09T22:12:33.153Z (5 months ago)
• Topics: coordinates, google-maps, maps, widget, yandex-maps, yii2-extension
• Language: JavaScript
• Size: 31.3 KB
• Stars: 1
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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.

[![Latest Stable Version](https://img.shields.io/packagist/v/alexantr/yii2-coordinates-input.svg)](https://packagist.org/packages/alexantr/yii2-coordinates-input)

[![Total Downloads](https://img.shields.io/packagist/dt/alexantr/yii2-coordinates-input.svg)](https://packagist.org/packages/alexantr/yii2-coordinates-input)

[![License](https://img.shields.io/github/license/alexantr/yii2-coordinates-input.svg)](https://raw.githubusercontent.com/alexantr/yii2-coordinates-input/master/LICENSE)

## Installation

Install extension through [composer](http://getcomposer.org/):

```

composer require alexantr/yii2-coordinates-input

```

## Configuring

At first set [Google Maps API key](https://developers.google.com/maps/documentation/javascript/get-api-key) in application config.

Additionally you can set [Yandex Maps language](https://tech.yandex.ru/maps/doc/jsapi/2.1/dg/concepts/localization-docpage/)

and initial coordinates for all maps.

```php

[

    '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:

```php

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

```

If you want to use this input widget in an ActiveForm, it can be done like this:

```php

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

```

All widget options with default values:

```php

= 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]`.