AltusVector Command Line

AltusVector v2.0.ut-2153-g60764257e
AltusVector - Vector tile creator. Copyright (c) 2016 BA3, LLC. ALL RIGHTS RESERVED.
USAGE: AltusVector [OPTIONS]
OPTIONS:
-db, --database_connect_string ARG   Database connection string.
-h, --help ARG                       Display usage instructions.
-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.
-of, --output_folder ARG             Output folder (i.e. /maps/mapdata)
-s, --session_file ARG               Name of Altus MapShop session .sqlite file.
-sl, --start_level ARG               Starting level to begin at.
-tid, --tile_id ARG                  Unique 64-bit Altus tile ID of tile to
                                     generate
-us_bounds, --united_states_bounds   Use continental United States bounds.
EXAMPLES:
Command line usage:
==================
AltusVector May be called from the command line or as a CGI program. (See CGI section for web use).
Command line usage
==================
To generate a single tile (i.e. an internet-based tile server):
    AltusVector -s MyMapDesign.sqlite -db "dbname=Foo user=Foo password=Foo hostaddr=127.0.0.1 port=5432"-tid 3170534653064924773 -of tilecache
To generate a full map to level 10:
    AltusVector -s MyMapDesign.sqlite -db "dbname=NorthAmerica user=metool password=metool hostaddr=192.168.0.25 port=5432" -ml 10 -of /Users/Me/MyVectorMaps/MyMap
To generate a map for the US bewteen level 5 and 12:
    AltusVector -minX -125 -minY 24 -maxX -65 -maxY 50 -sl 5 -ml 12 [plus other settings as above]
CGI usage
=========
AltusVector can create and serve vector tiles on-the-fly as needed
on a web server. For example, on Apache2, enable mod_rewrite, and create a .htaccess file
like this in the target url's physical folder:
--- beginning of .htaccess file ---
RewriteEngine On
RewriteCond   /%{REQUEST_FILENAME} !-f
RewriteRule   ^(.+) cgi-bin/AltusVector?\ 
db=dbname&eq;NorthAmerica&sp;user&eq;metool&sp;password&eq;metool&sp;hostaddr&eq;127.0.0.1&sp;port&eq;5432&\ 
minX=-180&minY;=-90&maxX;=180&maxY;=90&\ 
s=/home/bruce/develop/Skypack/Server/Programs/AltusVector/test/AltusVectorTest.sqlite&\ 
o=/home/bruce/develop/Skypack/Server/Programs/AltusVector/apache2/www&\ 
ml=20&\ 
sl=9&\ 
tilerequest=$1 
--- end of .htaccess file ---
Now when an http request comes in for a tile like this:
http://yourserver.yourfolder/cgi-bin/AltusVector?3170534653064924773.dat
 -or this-
http://yourserver.yourfolder/cgi-bin/AltusVector?/3/23/2.dat
If it is not found, Apache will call AltusVector and pass all the necessary commands to generate the tile.
By default, AltusVector will write the file to disk and then serve up the request. Subsequent http request
for the same tile can be fulfilled by the web server since the tile is now created.
AltusVector v2.0.ut-2153-g60764257e Copyright (c) 2016 BA3, LLC. ALL RIGHTS RESERVED.
Built from commit: 60764257e4ba51dd571dee9d649af206c6fe58ff