README

Laravel 5 框架的定制 PHP 地理编码库 - 由Ixudra开发。

此包任何人任何时候都可以使用，但请注意，它是针对我个人的定制工作流程优化的。它可能不完全适合您的项目，可能需要进行修改。

安装

通过 Composer 拉取此包。

    {
        "require": {
            "ixudra/geo": "5.*"
        }
    }

将服务提供者添加到您的 config/app.php 文件

    providers       => array(

        //...
        'Ixudra\Geo\GeoServiceProvider',

    ),

将外观添加到您的 config/app.php 文件

    facades         => array(

        //...
        'Geo'          => 'Ixudra\Geo\Facades\Geo',

    ),

使用

安装包后，您可以在代码中开始使用它

    $response = Geo::geocode('Mersenhovenstraat 5, 3722 Kortessem');

    // Will return the following response:
    //
    // {
    //     "status": "success"
    //     "lat": 50.8565248
    //     "lng": 5.391962
    // }

如果 GeoCoder 实例找不到任何结果，将抛出 Ixudra\Geo\Exceptions\EmptyResponseException。如果 GeoCoder 实例遇到某种类型的错误，将抛出 Ixudra\Geo\Exceptions\ErrorResponseException

配置选项

发布配置文件

该包有多个配置选项。为了修改这些选项，您需要使用 artisan 发布配置文件

    // Publish all resources from all packages
    php artisan vendor:publish

    // Publish only the resources of the package
    php artisan vendor:publish --provider="Ixudra\\Geo\\GeoServiceProvider"

这将创建一个配置文件并将其发布为 config/geo.php。默认情况下，配置文件将如下所示

    return array(

        'service'                   => 'google',


        // Google specific configuration
        'google'                    => array(

            'api_key'                   => '',

        ),


        // MapQuest specific configuration
        'mapQuest'                  => array(

            'api_key'                   => '',

        ),

    );

可以使用 service 键选择您想使用的特定地理编码器。默认设置为 google。目前仅支持 google 和 mapQuest。选择地理编码器后，您可以向其特定的配置数组添加 API 配置。

这就完成了！祝您玩得开心！

许可证

此模板是开源软件，根据MIT 许可证授权。

联系

Jan Oris (开发者)

• 电子邮件：jan.oris@ixudra.be
• 电话：+32 496 94 20 57