/dvs/git/dirty/gitlab-master_av/dw/sdk/tools/maps/maptool_zenrin_to_dw_maps/README-maptool_zenrin_to_dw_maps.md

Go to the documentation of this file.

# Copyright (c) 2018-2019, NVIDIA CORPORATION.  All rights reserved.

@page dwx_maptool_zenrin_to_dw_maps ZENRIN Maps to DriveWorks Maps Tool
@tableofcontents

The NVIDIA<sup>&reg;</sup> DriveWorks maptool_zenrin_to_dw_maps tool reads ZENRIN maps data and generates a Driveworks maps file. Note, it is the users' responsibility to obtain proper credentials to access ZENRIN HD maps data.

@section dwx_map_zenrin_prerequisites Prerequisites

This program assumes that you have valid credentials to access Zenrin's servers,
which are saved as a file, that you have received from Zenrin, in your home folder
or some other place of your choosing.

This file can be named as you wish, but the full name, including path, should be
supplied for the program to be able to access map database and other
things. For convenience, in this document the file is named settings.db, but
feel free to replace it with the actual name of the settings file you have.

This tool creates output files that, per default, are put into the current working
directory. Hence, write permissions to the current working directory are necessary.
For convenience, NVIDIA suggests that you add the tools folder to the binary search
path of the system and execute from your home directory.

@section dwx_map_zenrin_usage Usage

1. Read ZENRIN maps data and convert to a Driveworks maps file along a route defined by a kml file:

       ./maptool_zenrin_to_dw_maps settings.db [route_kml_file] [output_file] [size] (options)
   For example:

       ./maptool_zenrin_to_dw_maps settings.db \
        --route_kml_file=route.kml \
        --size=3000 \
        --output_file=dwMapCache.bin

2. Read ZENRIN maps data and convert to a Driveworks maps file along a route defined by a DW GPS file:

       ./maptool_zenrin_to_dw_maps settings.db [dw_gps_file] [output_file] [size] (options)
   For example:

       ./maptool_zenrin_to_dw_maps settings.db \
        --dw_gps_file=dwGPSfile.bin \
        --size=3000 \
        --output_file=dwMapCache.bin

3. Read ZENRIN maps data and convert to a Driveworks maps file within a region defined by a rectangle:

       ./maptool_zenrin_to_dw_maps settings.db [minLon] [maxLon] [minLat] [maxLat] (options)
   For example:

       ./maptool_zenrin_to_dw_maps settings.db \
        --minLon=-122.3 \
        --maxLon=-122.2 \
        --minLat=37.4 \
        --maxLat=37.5 \
        --output_file=dwMapCache.bin

@section dwx_map_zenrin_options Options

    --maxLat: default=-121.867341
        Maximum latitude of a map for rectangular query
    --maxLon: default=37.470751
        Maximum longitude of a map for rectangular query
    --minLat: default=-122.067341
        Minimum latitude of a map for rectangular query
    --minLon: default=37.270751
        Minimum longitude of a map for rectangular query
    --output_file: default=dwMapCache.bin
        Output Driveworks maps file name in '.xml' or '.bin' format
    --size: default=1000 (min: 600m)
        Size in meter for the KML/size query
    --route_kml_file: default=
        Input kml file extracted from Google maps after specifying a route

@section dwx_map_zenrin_creating Creating a route kml file
1. Go to https://www.google.com/mymaps/
2. Create a new map or open an existing map.
3. Click 'Add direction' button under the search tab.
4. It is going to create a new layer for the direction (let's call this layer the route layer).
5. Create your route on the route layer.
6. When finished, click menu button (3 dots) next to the map title and select 'export to kml/kmz'
7. Choose the route layer instead of entire map, check 'export to .KML file' and click download.
8. A sample route kml can be found in data/tools/maps/route.kml