Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/2amigos/yii2-google-maps-library
Google Maps API library for Yii2
https://github.com/2amigos/yii2-google-maps-library
2amigos google maps yii
Last synced: 6 days ago
JSON representation
Google Maps API library for Yii2
- Host: GitHub
- URL: https://github.com/2amigos/yii2-google-maps-library
- Owner: 2amigos
- License: bsd-3-clause
- Archived: true
- Created: 2014-09-24T14:00:47.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2021-03-19T22:43:45.000Z (almost 4 years ago)
- Last Synced: 2024-09-22T22:01:56.158Z (4 months ago)
- Topics: 2amigos, google, maps, yii
- Language: PHP
- Homepage: https://2amigos.us
- Size: 188 KB
- Stars: 106
- Watchers: 32
- Forks: 78
- Open Issues: 53
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
yii2-google-maps-library
========================
Google Maps API library for Yii2
[](https://packagist.org/packages/2amigos/yii2-google-maps-library) [](https://packagist.org/packages/2amigos/yii2-google-maps-library) [](https://packagist.org/packages/2amigos/yii2-google-maps-library) [](https://packagist.org/packages/2amigos/yii2-google-maps-library)
Introduction
------------
Even though we already created an extension to display maps that are away from Google's policies and works with
[LeafLetJs](http://leafletjs.com/ "http://leafletjs.com/") library, we still received requests to have
[EGMap extension for Yii1](http://www.yiiframework.com/extension/egmap) updated. So we thought that we should update
this library and make it work with Yii2 if we were to update it. Thats the reason behind the creation of this extension.
Nevertheless, it is important to note that we didn't have time (**yet**) to write any good documentation about it.
We wanted to publish it already, just in case somebody working with Yii2 was missing the EGMap library for its projects,
and wishes to update us with its tests and bug findings.
The github repository will keep being updated, and documentation well written for its usage. So please, do not be
impatient. If you do, any help will be highly appreciated.
## Installation
The preferred way to install this extension is through [composer](http://getcomposer.org/download/).
Either run
```
php composer.phar require "2amigos/yii2-google-maps-library" "*"
```
or add
```json
"2amigos/yii2-google-maps-library" : "*"
```
to the require section of your application's `composer.json` file.
## Usage
Even though there will be plenty of examples on how to use it, here is one that will provide you with a glimpse of its
usage:
## Service
```php
use dosamigos\google\maps\LatLng;
use dosamigos\google\maps\services\DirectionsWayPoint;
use dosamigos\google\maps\services\TravelMode;
use dosamigos\google\maps\overlays\PolylineOptions;
use dosamigos\google\maps\services\DirectionsRenderer;
use dosamigos\google\maps\services\DirectionsService;
use dosamigos\google\maps\overlays\InfoWindow;
use dosamigos\google\maps\overlays\Marker;
use dosamigos\google\maps\Map;
use dosamigos\google\maps\services\DirectionsRequest;
use dosamigos\google\maps\overlays\Polygon;
use dosamigos\google\maps\layers\BicyclingLayer;
$coord = new LatLng(['lat' => 39.720089311812094, 'lng' => 2.91165944519042]);
$map = new Map([
'center' => $coord,
'zoom' => 14,
]);
// lets use the directions renderer
$home = new LatLng(['lat' => 39.720991014764536, 'lng' => 2.911801719665541]);
$school = new LatLng(['lat' => 39.719456079114956, 'lng' => 2.8979293346405166]);
$santo_domingo = new LatLng(['lat' => 39.72118906848983, 'lng' => 2.907628202438368]);
// setup just one waypoint (Google allows a max of 8)
$waypoints = [
new DirectionsWayPoint(['location' => $santo_domingo])
];
$directionsRequest = new DirectionsRequest([
'origin' => $home,
'destination' => $school,
'waypoints' => $waypoints,
'travelMode' => TravelMode::DRIVING
]);
// Lets configure the polyline that renders the direction
$polylineOptions = new PolylineOptions([
'strokeColor' => '#FFAA00',
'draggable' => true
]);
// Now the renderer
$directionsRenderer = new DirectionsRenderer([
'map' => $map->getName(),
'polylineOptions' => $polylineOptions
]);
// Finally the directions service
$directionsService = new DirectionsService([
'directionsRenderer' => $directionsRenderer,
'directionsRequest' => $directionsRequest
]);
// Thats it, append the resulting script to the map
$map->appendScript($directionsService->getJs());
// Lets add a marker now
$marker = new Marker([
'position' => $coord,
'title' => 'My Home Town',
]);
// Provide a shared InfoWindow to the marker
$marker->attachInfoWindow(
new InfoWindow([
'content' => '
This is my super cool content
'
])
);
// Add marker to the map
$map->addOverlay($marker);
// Now lets write a polygon
$coords = [
new LatLng(['lat' => 25.774252, 'lng' => -80.190262]),
new LatLng(['lat' => 18.466465, 'lng' => -66.118292]),
new LatLng(['lat' => 32.321384, 'lng' => -64.75737]),
new LatLng(['lat' => 25.774252, 'lng' => -80.190262])
];
$polygon = new Polygon([
'paths' => $coords
]);
// Add a shared info window
$polygon->attachInfoWindow(new InfoWindow([
'content' => '
This is my super cool Polygon
'
]));
// Add it now to the map
$map->addOverlay($polygon);
// Lets show the BicyclingLayer :)
$bikeLayer = new BicyclingLayer(['map' => $map->getName()]);
// Append its resulting script
$map->appendScript($bikeLayer->getJs());
// Display the map -finally :)
echo $map->display();
```
## Client
```php
use dosamigos\google\maps\services\DirectionsClient;
$direction = new DirectionsClient([
'params' => [
'language' => Yii::$app->language,
'origin' => 'street from',
'destination' => 'street to'
]
]);
$data = $direction->lookup(); //get data from google.maps API
```
This extension has also a plugin architecture that allow us to enhance it, so expect plugins to be developed in near
future too.
## Configuration
To configure the Google Map key or other options like language, version, library, use the [Asset Bundle customization](http://www.yiiframework.com/doc-2.0/guide-structure-assets.html#customizing-asset-bundles) feature.
```php
'components' => [
'assetManager' => [
'bundles' => [
'dosamigos\google\maps\MapAsset' => [
'options' => [
'key' => 'this_is_my_key',
'language' => 'id',
'version' => '3.1.18'
]
]
]
],
],
```
To get key, please visit https://code.google.com/apis/console/
## Using code sniffer
Once you do `composer install -o`, the `php-cs-fixer` tool will be added to your vendor file. To fix the formatting of
your php files, simply do:
```bash
./vendor/bin/php-cs-fixer --config=.php_cs.dist fix
```
## Resources
* [Google Maps API Reference](https://developers.google.com/maps/documentation/)
* [GitHub](https://github.com/2amigos/yii2-google-maps-library)
* [2amigOS Packagist Profile](https://packagist.org/packages/2amigos/)
> [](http://www.2amigos.us)
beyond software
[www.2amigos.us](http://www.2amigos.us)