damienharper/navigation-bundle

Provides routing, distance matrix features etc from different providers

0.5.0 2020-11-09 09:31 UTC

Requires

• php: >=7.1
• ext-json: *
• guzzlehttp/guzzle: ^6.2
• symfony/framework-bundle: ^4.4|^5.0
• symfony/options-resolver: ^4.4|^5.0

Requires (Dev)

• matthiasnoback/symfony-dependency-injection-test: ^3.1|^4.0
• phpstan/phpstan: ^0.12
• phpstan/phpstan-doctrine: ^0.12
• phpstan/phpstan-symfony: ^0.12
• phpunit/phpunit: ^7.0|^8.0|^9.0
• symfony/console: ^4.4|^5.0
• symfony/var-dumper: ^4.4|^5.0

MIT

• Damien Harper

• routing
• distance matrix

README

This bundle provides navigation features such as routing, distance matrix etc. It relies on providers to provide such features. Included providers are:

• Here (see https://developer.here.com)
• [not yet available] Google Maps (see https://developers.google.com/maps/documentation/)

Installation

Applications that use Symfony Flex

Open a command console, enter your project directory and execute:

composer require damienharper/navigation-bundle

Applications that don't use Symfony Flex

Step 1: Download the Bundle

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

composer require damienharper/navigation-bundle

This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.

Step 2: Enable the Bundle

Then, enable the bundle by adding it to the list of registered bundles in the app/AppKernel.php file of your project:

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...
            new DH\NavigationBundle\DHNavigationBundle(),
        );

        // ...
    }

    // ...
}

Configuration

Providers

Credentials for providers (API tokens/keys) have to be defined in the dh_navigation.yaml configuration file.

// config/packages/dh_navigation.yaml
dh_navigation:
    providers:
        here:
            factory: DH\NavigationBundle\Provider\Here\HereFactory
            options:
                app_id: "HERE_APP_ID"
                app_code: "HERE_APP_CODE"
                use_cit: false
        google_maps:
            factory: DH\NavigationBundle\Provider\GoogleMaps\GoogleMapsFactory
            options:
                api_key: "GOOGLE_MAPS_TOKEN"

Usage

sample code here

Contributing

NavigationBundle is an open source project. Contributions made by the community are welcome. Send us your ideas, code reviews, pull requests and feature requests to help us improve this project.

Do not forget to provide unit tests when contributing to this project. To do so, follow instructions in this dedicated README

License

NavigationBundle is free to use and is licensed under the MIT license