Skip to main content

Adding or updating a roadnet

Related page: Global DCC Routing API - Adding a new region.

How to - Add a roadnet​

  1. Get a DCC data file to add.
    • See the ones already generated here.
    • If you need a new one, reach out to Pavan Jonnala from AMCS Global Support on Teams.
  2. Find the 2-letter country code of your roadnet at https://www.iso.org/obp/ui/#search/code/.
  3. Find the roadnetId. Format is
    • {2-letter country code} for a whole country
    • {2-letter country code}-{2-letter state code} for a state in USA or Canada
    • {2-letter country code}-{2-letter state code}-{2-letter state code}... for several states in USA or Canada
    • {2-letter country code}-{2-letter or 3-letter state code} for a state in Australia
  4. In Azure file share for DCC roadnets (portal.azure.com > Storage account > eu1gdccdevst > File shares > mapdata).
    • Place your DCC data file under {roadnetId}/default/Roadnet
    • Place a DccMulti.xml file under {roadnetId}/default
    • Place RNUpdates.xml file under {roadnetId}/default/Data
    • Check the other roadnet folders for inspiration.
    • Note: it is easier to use Azure Storage Explorer (to be downloaded and installed) in order to do it.
    • Note: the storage account 'eu1gdccdevst' is for EU-DEV environment.
  5. Add the roadnet in GlobalDccDeploymentK8\manifests\overlays\dev\eu-dev\roadnets.yaml.
    • Note the link is for EU-DEV environment.
  6. Once deployed, add a distance test here so it covers the added roadnet.

Follow the same steps to add a roadnet to other regions (EU, NA, AU) and stages (DEV, STG, PRD).

How to - Update a roadnet​

Example: there is already a roadnet for Denmark but it is old. A new version is available.

You can follow the same steps as above except that, in Azure file share for DCC roadnets, you should place the new roadnet in a new folder (ex: "2021Q2") next to the "default" folder.

Then you should reach the deployed Roadnet Manager and tell about the new roadnet. At the time of writing this documentation (30/03/2023), DevOps is still working on Roadnet Manager. We expect a Swagger endpoint where we can post request with data (roadnet id, "2021Q2"). It will trigger that Global DCC backends will upgrade their roadnet in the background.

Note: The whole Roadnet Manager is left at stage 1. And stage 2 (adding cache recalculation) will probably change this process.