AltusMarker v2.0.ut-2153-g60764257e
AltusMarker - Altus Mapping Engine Marker Map Generator.
This program is for creating an Altus compatible clustered marker map databases, or
optionally, adding (injecting) Altus Marker Map database tables into an existing sqlite database.
You can also optionally use this program to create a JSON representation of your input marker data.
This program is intended for scenarios where the number of geographic points of interest
to be clustered would take too long to do on a portable device.
You can provide data for your markers 2 ways, as a tab-delimited file, or from a sqlite database.
Setting the -sql parameter to a valid query string implies the source is a sqlite database.
If the output is an existing sqlite database file, marker data will be added to the existing database.
The same sqlite data can be the input and output file (previously called marker injection).
Tab Delimited Input:
====================
Tab-delimited text file columns should be:
1) Marker metadata (i.e. "New York")
2) Latitude (i.e. "-45.32")
3) Longitude (i.e. "53.01")
4) Weight (i.e. "1002.231")
5) Minimum level (i.e. "5")
Column 4, Weight, and column 5, Minimum level, are optional and will default to 0.
The higher a marker's weight, the more importance is placed on it being displayed
during rendering in the Altus Mapping Engine.
The -clusterdistance option controls how close in screen points at render-time that
clustered markers may be to one another. If any two clustered marker gets closer than
this distance, the one with the higher weight will be chosen and the other will fade.
SQLite Input
============
In this scenario, the input file is an existing sqlite database that contains your marker data.
You will provide a SQL query on the command-line that is used to get the marker data.
For example, this query:
SELECT metadata, longitude, latitude, weight, 0 FROM MyTable
would be run to get marker data.
The output file can be the same as the input file, but note that you must specify a
table name prefix (see -tnp option) if you wish to have side-by-side clustered
marker tables in the same sqlite file.
NOTES: 1) This program requires sqlite R-Tree support. 2) Not all of your source markers will necessarily
be added, especially if they overlap each other, you choose a small cluster distance, or choose a low level. Copyright (c) 2016 BA3, LLC. ALL RIGHTS RESERVED.
USAGE: AltusMarker [OPTIONS]
OPTIONS:
-cd, --cluster_distance ARG Controls screen unit distance between
clustered markers.
-h, --help ARG Display usage instructions.
-i, --input_file ARG Tab-delimited or sqlite file containing
marker data. If sqlite, you must specify a
valid sql query string using the -sql
option.
-json, --output_json Output JSON representation.
-lk, --license_key ARG Commercial-use license key. (i.e.
"01234567-0123-0123-0123-012345678901")
-maxX, --maximum_x ARG East-most edge of output map data.
-maxY, --maximum_y ARG Northern-most edge of output map data.
-minX, --minimum_x ARG West-most edge of output map data.
-minY, --minimum_y ARG Southern-most edge of output map data.
-ml, --max_level ARG Maximum level to generate. If not
specified, the optimum level will be
computed automatically.
-o, --output_file ARG Name of sqlite file to create or to add to.
-sql, --sql_select_statement ARG A sql statement that will return markers
data needed for clustering.
-tnp, --table_name_prefix ARG Prefix all generated tables with this
prefix. Use with -im option.
-us_bounds, --united_states_bounds Use continental United States bounds.
-zorder ARG
EXAMPLES:
Command line usage:
==================
Create a marker map from a tab-delimited text file:
AltusMarker -i Places.txt\
-zorder 100 \
-ml 20 \
-cd 100 \
-o Places.sqlite
AltusMarker v2.0.ut-2153-g60764257e Copyright (c) 2016 BA3, LLC. ALL RIGHTS RESERVED.
Built from commit: 60764257e4ba51dd571dee9d649af206c6fe58ff
AltusMappingEngine Server v2.0.ut.2153.g60764257e master
COPYRIGHT (C) 2017, BA3, LLC ALL RIGHTS RESERVED