README

Google Maps Yii2 封装

安装

安装此扩展的首选方式是通过 composer.

运行以下命令之一：

php composer.phar require --prefer-dist tugmaks/yii2-google-maps "*"

或添加

"tugmaks/yii2-google-maps": "*"

到您的 composer.json 文件的 require 部分。

必读

Google Maps JavaScript API v3

基本用法

扩展安装后，只需在您的代码中使用它即可

use tugmaks\GoogleMaps\Map;

echo Map::widget([
    'zoom' => 16,
    'center' => 'Red Square',
    'width' => 700,
    'height' => 400,
    'mapType' => Map::MAP_TYPE_SATELLITE,
]);

设置 API KEY 的两种方法

添加到应用程序参数。

config/params.php

return [
.....
'GOOGLE_API_KEY' => 'VIza7yBgBzYEbKx09V566DhM8Ylc3NjWsJ0ps-2' // use your own api key
.....
]

或直接传递给小部件。

use tugmaks\GoogleMaps\Map;

echo Map::widget([
    'apiKey'=> 'VIza7yBgBzYEbKx09V566DhM8Ylc3NjWsJ0ps-2',
    'zoom' => 3,
    'center' => [20, 40.555],
    'width' => 700,
    'height' => 400,
    'mapType' => Map::MAP_TYPE_HYBRID,
]);

参数

标记

可以在地图上添加一个或多个标记。只需将标记数组传递给小部件配置

use tugmaks\GoogleMaps\Map;

echo Map::widget([
    'zoom' => 5,
    'center' => [45, 45],
    'width' => 1100,
    'height' => 600,
    'mapType' => Map::MAP_TYPE_HYBRID,
    'markers' => [
        ['position' => 'Erevan'],
        ['position' => 'Moscow'],
        ['position' => 'Ankara'],
        ['position' => 'Kazan'],
        ['position' => 'Sofia'],
    ]
]);

标记选项

以下选项是允许的

标记适应范围

有时您需要在地图上显示所有标记，但不知道初始地图中心和缩放级别。在这种情况下，请使用类似以下的小部件

use tugmaks\GoogleMaps\Map;

echo Map::widget([
    'width' => 1100,
    'height' => 600,
    'mapType' => Map::MAP_TYPE_HYBRID,
    'markers' => [
        ['position' => 'Belgrad'],
        ['position' => 'Zagreb'],
        ['position' => 'Skopje'],
        ['position' => 'Podgorica'],
        ['position' => 'Sarajevo'],
    ],
    'markerFitBounds'=>true
]);