dnery / laravel-maps
一个简单地将 Google Maps WebServices 集成到您的 Laravel 应用程序中的包。
Requires
- php: >=7.0
- illuminate/support: 5.5.*
- laravel/framework: 5.5.*
README
Laravel Maps 是一个简单的包,帮助您将 Laravel 与 Google Maps WebServices 连接起来。
安装
Composer
使用以下命令在 Laravel 5.5+ 上安装此包
$ composer require dnery/laravel-maps:2.1.*
或者将包添加到 composer.json 文件中 require 对象
{
"require": {
"dnery/laravel-maps": "2.1.*"
}
}
要在 Laravel 4 上使用此包,请安装包的旧版本
$ composer require dnery/laravel-maps:1.0.3
不使用 Composer
只需下载仓库,并将其安装到您的 Laravel 项目 vendor/ 目录下。
在项目中安装包后,将包的服务提供者添加到 app/config/app.php 中的 providers 部分
'Dnery\LaravelMaps\LaravelMapsServiceProvider',
同时,在 aliases 部分添加 LaravelMaps 包的别名
'LaravelMaps' => 'Dnery\LaravelMaps\Facades\LaravelMaps',
在项目中发布包的配置文件
php artisan config:publish dnery/laravel-maps
用法
首先,在生成的配置文件中填写您的 api_key(您可以在 Google Developers Console 的面板中找到它),该文件位于 app/config/packages/dnery/laravel-maps/config.php。之后,您只需使用您想要使用的 WebService 名称初始化 LaravelMaps。
$geocode = Laravel::init('geocode')
目前,LaravelMaps 可以与 Google Maps 的 4 个 WebService 集成
- Google Maps Distance Matrix API (https://developers.google.com/maps/documentation/distance-matrix/?hl=pt-br)
LaravelMaps::init('distance-matrix');
- Google Places API Web Service (https://developers.google.com/places/web-service/?hl=pt-br)
LaravelMaps::init('places');
- Google Maps Geocoding Api (https://developers.google.com/maps/documentation/geocoding/?hl=pt-br)
LaravelMaps::init('geocode');
- Google Maps Directions API (https://developers.google.com/maps/documentation/directions/?hl=pt-br)
LaravelMaps::init('directions');
在使用 Geocoding、Directions 和 Distance Matrix API 时,只需调用 $maps->process($params); - 您可以在 Google 上找到这些参数的用法,具体链接见上方。
在使用 Places API 时,调用 $maps->run('method', $params);
贡献
这是一个因为我维护的项目中的个人需求而创建和发布的包。请随意提交 pull request 和问题,以帮助改进此包。