fourello-devs/openstreetmap

This package is abandoned and no longer maintained. No replacement package was suggested.

Laravel-flavored OpenStreetMap SDK

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

Requires

• illuminate/support: ~7|~8

Requires (Dev)

• orchestra/testbench: ~5|~6
• phpunit/phpunit: ~9.0

MIT

• James Carlo Luchavez

• laravel
• OpenStreetMap

README

This is where your description should go. Take a look at contributing.md to see a to do list.

Installation

Via Composer

$ composer require fourello-devs/openstreetmap

Usage

This package offers two convenient way to directly use OpenStreetMap.

• OpenStreetMap facade
• osm() helper function

There are three (3) methods available for you to use:

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

This package is some form of Laravel-flavored SDK for OpenStreetMap. To learn more about OpenStreetMap, please refer to this documentation.

Note: There should be five (5) methods supposedly but due to time constraint and project requirements, the remaining two which are Address Lookup and Details are not included. You can fork this project for free. If given a chance, I will include the remaining two in the future.

Setup Environment Variables

# (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=[e-mail]

For complete list of country codes, visit Wikipedia.

If you are making large numbers of request please include an appropriate email address to identify your requests. See Nominatim's Usage Policy for more details.

Demonstration

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);
    
});

Change log

Please see the changelog for more information on what has changed recently.

Testing

$ composer test

Contributing

Please see contributing.md for details and a todolist.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

• James Carlo Luchavez
• All Contributors

License

MIT. Please see the license file for more information.