pschocke / google-maps-links
easily create google maps links to link to a map
Requires
- php: ^7.3
Requires (Dev)
- friendsofphp/php-cs-fixer: ^2.16
- phpunit/phpunit: ^9.0
This package is auto-updated.
Last update: 2024-10-30 01:39:51 UTC
README
This package adds a lightweight way to link to a specific location, start a direction, show a map or jump into street view in google maps.
Installation
You can install the package via composer:
composer require pschocke/google-maps-links
Usage
Search
You can search for a location or coordinates. Optionally you can add a place id that google maps will use if it can't find your specified location/coordinates
$gMapsLocation = new pschocke\GoogleMapsLinks\GMapsLocation(); // Get the link to a specific search location $link = $gMapsLocation->location('Towerbridge'); // Get the link to coordinates $link = $gMapsLocation->coordinates('53.541321', '9.983945'); // Optionally attach a query_place_id $link = $gMapsLocation->queryPlaceId('ChIJT8RwZwaPsUcRhkKYaCqr5LI')->coordinates('53.541321', '9.983945'); $link = $gMapsLocation->queryPlaceId('ChIJT8RwZwaPsUcRhkKYaCqr5LI')->location('Towerbridge');
Direction
You can show a direction:
$gMapsDirection = new pschocke\GoogleMapsLinks\GMapsDirection(); // Get the link to start a direction from a specific place $link = $gMapsDirection->from('Towerbridge')->get(); // Get the link to start a direction from a specific place to a specific place $link = $gMapsDirection->from('Towerbridge')->to('Big Ben')->get(); // Optionally specify a travel method $link = $gMapsDirection->from('Towerbridge')->to('Big Ben')->travelMethod('bicycling')->get();
Map
You can link to a map with no markers:
$gMapsMap = new pschocke\GoogleMapsLinks\GMapsMap(); // Get the link to start a map by specifing a center coordinate $link = $gMapsMap->center('-33.712206', '150.311941')->get(); // Optionally specify a zoom level ranging from 0 (the whole world) to 21 (individual buildings), defaults to 15 $link = $gMapsMap->center('-33.712206', '150.311941')->zoom(6)->get(); // Optionally change the basemap (roadmap (default), satellite, or terrain) $link = $gMapsMap->center('-33.712206', '150.311941')->basemap('satellite')->zoom(6)->get(); // Optionally change the layer of the map: none (default), transit, traffic, or bicycling $link = $gMapsMap->center('-33.712206', '150.311941')->layer('transit')->basemap('satellite')->zoom(6)->get();
Street View
You can create a link to directly open a street view panorama
$gMapsStreetView = new pschocke\GoogleMapsLinks\GMapsStreetView(); // Get the link to display a panorama from a viewpoint cooridnate $link = $gMapsStreetView->viewpoint('48.857832', '2.295226')->get(); // You can also provide a pano id, the viewpoint is used if the pano id does not exisits $link = $gMapsStreetView->pano('tu510ie_z4ptBZYo2BGEJg')->viewpoint('48.857832', '2.295226')->get(); // Optionally you can change the heading, pitch and fov parameter $link = $gMapsStreetView->pano('tu510ie_z4ptBZYo2BGEJg')->viewpoint('48.857832', '2.295226')->heading('-45')->pitch(38)->fov(80)->get();
Testing
composer test
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email patrick@ausbildung-ms.de instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.