LaPoste DataNOVA (open-data API) client and proxy Symfony bundle.

Fetch and/or search in datasets from LaPoste DataNOVA.

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

$ composer require florianajir/datanova-bundle

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

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

<?php
// src/config/bundles.php
return [
    // ...
    Fmaj\LaposteDatanovaBundle\FmajLaposteDatanovaBundle::class => ['all' => true],
    // ...
];

To use the bundle proxy API, import the bundle routing file in the src/config/routing.yml file of your project:

data_nova:
    resource: "@FmajLaposteDatanovaBundle/Resources/config/routing.yml"
    prefix:   /datanova

/records/search/{dataset}/{query}/{sort}/{rows}/{start} 

Example: http://{localhost}/datanova/records/search/laposte_hexasmal/code_postal:34000/nom_de_la_commune Example: http://{localhost}/datanova/records/search/laposte_hexasmal/paris/code_postal/10/10

/records/download/{dataset}.{_format}/{query} 

Example: http://{localhost}/datanova/records/download/laposte_hexasmal.json Example: http://{localhost}/datanova/records/download/laposte_hexasmal.csv/974

To improve search performances, use the data_nova:download:dataset command to cache dataset for better web search performances. More details in dataset download command documentation.

# /bin/bash
php bin/console datanova:download:dataset -h
Usage:
  datanova:download:dataset [options] [--] <dataset> [<format>] [<q>]

Arguments:
  dataset               Which dataset to download?
  format                Data file format : CSV (default), JSON [default: "CSV"]
  q                     query filter, by default all results will be download

Options:
  -f, --force-replace   If set, the command will replace local storage

Example: php bin/console datanova:download:dataset laposte_hexasmal json -f