mirror of
https://gitlab.com/Chill-Projet/chill-bundles.git
synced 2025-11-23 04:17:45 +00:00
Change all content from rst format to markdown and correct spelling/grammar
This commit is contained in:
47
docs/source/installation/load-addresses.md
Normal file
47
docs/source/installation/load-addresses.md
Normal file
@@ -0,0 +1,47 @@
|
||||
###### Addresses
|
||||
|
||||
Chill can store a list of geolocated address references, which are used to suggest address and ensure that the data is correctly stored.
|
||||
|
||||
Those addresses may be loaded from a dedicated source.
|
||||
|
||||
## Countries
|
||||
|
||||
To load addresses into the chill application we first have to make sure that a list of countries is present.
|
||||
To import, the countries run the following command.
|
||||
|
||||
bin/console chill:main:countries:populate
|
||||
|
||||
## In France
|
||||
|
||||
The address is loaded from the [BANO ](https://bano.openstreetmap.fr/). The postal codes are loaded from [the official list of
|
||||
postal codes ](https://datanova.laposte.fr/explore/dataset/laposte_hexasmal/information/)
|
||||
|
||||
# first, load postal codes
|
||||
`bin/console chill:main:postal-code:load:FR`
|
||||
# then, load all addresses by departement (multiple departements can be loaded by repeating the departement code
|
||||
`bin/console chill:main:address-ref-from-bano 57 54 51`
|
||||
|
||||
## In Belgium
|
||||
|
||||
Addresses are prepared from the [BeST Address data ](https://www.geo.be/catalog/details/ca0fd5c0-8146-11e9-9012-482ae30f98d9).
|
||||
|
||||
Postal code is loaded from this database. There is no need to load postal codes from another source (actually, this is strongly discouraged).
|
||||
|
||||
The data are prepared for Chill ([See this repository ](https://gitea.champs-libres.be/Chill-project/belgian-bestaddresses-transform/releases)).
|
||||
One can select postal code by his first number (`1xxx` for postal codes from 1000 to 1999), or a limited list for development purpose.
|
||||
|
||||
The command expects a language code as the first argument.
|
||||
|
||||
# load postal code from 1000 to 3999:
|
||||
`bin/console chill:main:address-ref-from-best-addresse fr 1xxx 2xxx 3xxx`
|
||||
|
||||
# load only an extract (for dev purposes)
|
||||
`bin/console chill:main:address-ref-from-best-addresse fr extract`
|
||||
|
||||
# load full addresses (discouraged)
|
||||
`bin/console chill:main:address-ref-from-best-addresse fr full`
|
||||
|
||||
There is a possibility to load the full list of addresses is discouraged: the loading is optimized with smaller extracts.
|
||||
|
||||
Once you load the full list, it is not possible to load a smaller extract: each extract loaded **after** will not
|
||||
delete the addresses loaded with the full extract (and some addresses will be present twice).
|
||||
Reference in New Issue
Block a user