README

Requirements

PHP >= 7.1.3
Laravel >= 5.6

Installation

Install the package via composer:

composer require snezhkoigor/geocoding

If you are running Laravel 5.5 (the package will be auto-discovered), skip this step. Find the providers array key in config/app.php and register the Geocoding Service Provider:

// 'providers' => [
    Geocoding\Laravel\GeocodingServiceProvider::class,
// ];

Providers

By default, the configuration specifies a Chain provider, containing the GoogleMaps provider for addresses as well as reverse lookups with lat/long.

However, you are free to add or remove providers as needed, both inside the Chain provider, as well as along-side it. The following is the default configuration provided by the package:

<?php
use Geocoding\Laravel\Providers\DaData;

return [
    /*
    |--------------------------------------------------------------------------
    | Providers
    |--------------------------------------------------------------------------
    |
    */
    'providers' => [
        DaData::class => [
            'token' => env('DADATA_TOKEN', ''),
            'proxy' => env('DADATA_PROXY_IP', null)
        ]
    ]
];

Supported Providers

DaData

Customization

If you would like to make changes to the default configuration, publish and edit the configuration file:

php artisan vendor:publish --provider="Geocoding\Laravel\GeocodingServiceProvider" --tag="config"

Usage

The service provider initializes the geocoding service, accessible via the facade Geocoding::... or the application helper app('geocoding')->....

Geocoding of Address

app('geocoding')->geocode((\Geocoding\Laravel\Models\Query\GeocodeQuery::create('Санкт-Петербург')));

Result would be:

{
    "provided_by": "DaData.ru",
    "latitude": 59.9391313,
    "longitude": 30.3159004,
    "address": "г Санкт-Петербург"
}

Suggest and get Collection of Addresses

app('geocoding')->suggest((\Geocoding\Laravel\Models\Query\SuggestQuery::create('перво')));