fourello-devs/openstreetmap

此包已被弃用且不再维护。未建议替代包。

Laravel风格的OpenStreetMap SDK

dev-master 2021-05-08 22:33 UTC

This package is auto-updated.

Last update: 2023-03-27 19:15:59 UTC


README

Latest Version on Packagist Total Downloads Build Status StyleCI

这里应该是您的描述。请查看contributing.md以查看待办事项清单。

安装

通过Composer

$ composer require fourello-devs/openstreetmap

用法

此包提供两种方便的方式直接使用OpenStreetMap。

  • OpenStreetMap门面
  • osm()辅助函数

有三种(3)方法可供您使用

  • getSearch()
  • getReverse()
  • getStatus()

此包是OpenStreetMap的某种Laravel风格的SDK。要了解更多关于OpenStreetMap的信息,请参阅此文档

注意:理论上应有五种(5)方法,但由于时间限制和项目要求,剩下的两种地址查找详细信息未包括。您可以免费分叉此项目。如果有机会,我将在未来包含剩余的两种。

设置环境变量

# (optional) Comma-separated Country Codes
OSM_COUNTRY_CODES=PH,JP
# (optional) Number of places to display (min: 10, max: 50)
OSM_SEARCH_LIMIT=5
# (optional) 
OSM_EMAIL_ADDRESS=carlo.luchavez@fourello.com

要查看国家代码的完整列表,请访问维基百科

如果您正在发出大量请求,请包含适当的电子邮件地址以识别您的请求。有关详细信息,请参阅Nominatim的使用政策

演示

use FourelloDevs\OpenStreetMap\Models\Request\Reverse;
use FourelloDevs\OpenStreetMap\Models\Request\Search;

Route::get('status', function () {

    return osm()->getStatus();
    
});

Route::get('search', function () {

    $search = new Search();
    $search->q = 'Manila';
    $search->includeAddressDetails();
    $search->includeExtraTags();

    return osm()->getSearch($search);
    
});

Route::get('reverse', function () {

    $reverse = new Reverse();
    $reverse->lat = -34.4391708;
    $reverse->lon = -58.7064573;
    $reverse->includeAddressDetails();
    $reverse->includeExtraTags();

    return osm()->getReverse($reverse);
    
});

变更日志

请参阅changelog以获取有关最近更改的更多信息。

测试

$ composer test

贡献

请参阅contributing.md以获取详细信息及待办事项清单。

安全

如果您发现任何与安全相关的问题,请通过电子邮件carlo.luchavez@fourello.com联系,而不是使用问题跟踪器。

致谢

许可

MIT。有关更多信息,请参阅许可文件