Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/quexer69/yii2-google-api
A collection of google map api calls, staticmap, geocode, iframe map
https://github.com/quexer69/yii2-google-api
geocoder google-api staticmap yii2
Last synced: about 2 months ago
JSON representation
A collection of google map api calls, staticmap, geocode, iframe map
- Host: GitHub
- URL: https://github.com/quexer69/yii2-google-api
- Owner: Quexer69
- Created: 2015-01-23T21:50:18.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2017-08-14T11:38:04.000Z (over 7 years ago)
- Last Synced: 2024-11-11T17:50:16.648Z (about 2 months ago)
- Topics: geocoder, google-api, staticmap, yii2
- Language: PHP
- Size: 23.4 KB
- Stars: 2
- Watchers: 2
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Yii2 google api library
-----------------------------
[](https://packagist.org/packages/quexer69/yii2-google-api) [](https://packagist.org/packages/quexer69/yii2-google-api) [](https://packagist.org/packages/quexer69/yii2-google-api)
A collection of google map api calls, staticmap, geocode, iframe map
...for Google API v3, PHP >= 5.4.0, Yii 2.0.*
## Installation
The preferred way to install this component is through [composer](http://getcomposer.org/download/).
Either run
```
php composer.phar require --prefer-dist quexer69/yii2-google-api "2.0.*"
```
or add
```
"quexer69/yii2-google-api": "2.0.*"
```
to the require section of your `composer.json` file.
## Configuration
in your app and/or console configuration file, add these
```php
'components' => [
// Google Maps Image and Geocode API settings for \Yii::$app->googleApi component
'googleApi' => [
'class' => 'quexer\googleapi\GoogleApiLibrary',
// API Keys !!!
'staticmap_api_key' => '***************************************',
'geocode_api_key' => '***************************************',
// Set basePath
'webroot' => '@webroot',
// Image path and map iframe settings
'map_image_path' => '/images/google_map',
'map_type' => 'terrain',
'map_size' => '520x350',
'map_sensor' => false,
'map_zoom' => 9,
'map_scale' => 1,
'map_marker_color' => 'red',
'map_iframe_width' => '100%', // %, px, em
'map_iframe_height' => '500px', // %, px, em
'map_language' => 'de',
// Debug
'quiet' => false
],
...
],
```
## Public Methods
```php
\Yii::$app->googleApi->renderMapIframe($address, $latlng, $iFrameWidth, $iFrameHeight)
\Yii::$app->googleApi->createImage($address, $latlng, $setMarker)
\Yii::$app->googleApi->getGeoCodeObject($address, $latlng)
\Yii::$app->googleApi->getDistance($start, $finish, $unit)
\Yii::$app->googleApi->getBounds($address)
```
## Usage
Once the component is installed, simply use it in your code by:
```php
// Use $address OR $latlng
$address = '70180 Stuttgart, Germany';
$latlng = '48.7632145,9.174027';
```
**Create a Google map image**
```php
$relFilePath = \Yii::$app->googleApi->createImage($address, null, true);
```
**To simply get the Google geocode object**
```php
$relFilePath = \Yii::$app->googleApi->getGeoCodeObject(null, $latlng);
```
**Render a Google map iframe**
```php
$iframeMarkup = \Yii::$app->googleApi->renderMapIframe(null, $latlng);
```
**Calculate Distance between two geo points**
```php
$latlng_origin = ['48.7632145','9.174027'];
$latlng_destination = ['48.4525334','9.468254'];
$unit = 'miles'; // 'miles' or 'km'
$floatDistance = \Yii::$app->googleApi->getDistance($latlng_origin, $latlng_destination, $unit);
```
## See also
... a more extensive variant
* [2amigos/yii2-google-maps-library](https://github.com/2amigos/yii2-google-maps-library)
## Resources
* [Google Maps API Reference](https://developers.google.com/maps/documentation/)
* [Project on GitHub](Quexer69/yii2-google-api)
* [Quexer69 Packagist Profile](https://packagist.org/packages/Quexer69/)