A map series file contains a list of GeoPDF files/geospatially-aware PDF files included in the TerraGo MapBook and the values used for the index map labels and hyperlinks. The map series file can be in .csv or .xml file format.
In this document:
Common ways to create a map series file
You can create a map series file using the following applications:
-
MapBook Creation tool on the GeoPDF Composer Toolbar
-
Microsoft Excel
Fields in a map series .csv file
The following fields are in a map series file in .csv file format:
|
Name |
Type |
Description |
|---|---|---|
|
|
String |
The series in which a map belongs; allows multiple map sets to be defined; this is the label used for the layer name on which the grid and associated hyperlinks will be placed; the default value is Tiles (OPTIONAL) |
|
|
File |
The path to a GeoPDF file in a map series (MANDATORY) |
|
|
Integer |
The page number of the map in the GeoPDF file; the first page and default value is 1 (OPTIONAL) |
|
|
Integer |
The number of the map frame of interest; the first map frame is 1; the largest map frame on the page is 0; the last map frame on the page is -1; the default value is 0 (OPTIONAL) |
|
|
String |
The label used for the text on the index map grid; the default value is the base name of the GeoPDF file (OPTIONAL) |
|
|
String |
The label used for bookmarks that link to the map; the default value is the value of the ShortLabel (OPTIONAL) |
Sample .csv map series file
The sample below is a map series file in .csv file format. When you create your .csv file, do not include the actual field names in the file. Pipes and commas are the supported delimiters.
Series A|A01.pdf|1|-1|A01|Map A01 Series A|A02.pdf|1|-1|A02|Map A02 Series B|B01.pdf|1|-1|B01|Map B01 Series B|B02.pdf|1|-1|B02|Map B02 Series C|C01.pdf|1|-1|C01|Map C01 Series C|C02.pdf|1|-1|C02|Map C02 Series D|D01.pdf|1|-1|D01|Map D01 Series D|D02.pdf|1|-1|D01|Map D01
Sample .xml map series file
<?xml version='1.0' ?>
<MapSeries xmlns='http://www.terragotech.com/mapseries/1.0'>
<Series type='array'>
<Series type='dictionary'>
<Description type='string' Value='Series A' />
<Maps type='array'>
<Map type='dictionary'>
<PDF src='GeoRegistered/A01.pdf' />
<PageIndex type='integer' Value='1' />
<MapframeIndex type='integer' Value='-1' />
<ShortLabel type='string' Value='A01' />
<LongLabel type='string' Value='Map A01' />
</Map>
<Map type='dictionary'>
<PDF src='GeoRegistered/A02.pdf' />
<PageIndex type='integer' Value='1' />
<MapframeIndex type='integer' Value='-1' />
<ShortLabel type='string' Value='A02' />
<LongLabel type='string' Value='Map A02' />
</Map>
</Maps>
</Series>
<Series type='dictionary'>
<Description type='string' Value='Series B' />
<Maps type='array'>
<Map type='dictionary'>
<PDF src='GeoRegistered/B01.pdf' />
<PageIndex type='integer' Value='1' />
<MapframeIndex type='integer' Value='-1' />
<ShortLabel type='string' Value='B01' />
<LongLabel type='string' Value='Map B01' />
</Map>
<Map type='dictionary'>
<PDF src='GeoRegistered/B02.pdf' />
<PageIndex type='integer' Value='1' />
<MapframeIndex type='integer' Value='-1' />
<ShortLabel type='string' Value='B02' />
<LongLabel type='string' Value='Map B02' />
</Map>
</Maps>
</Series>
</Series>
</MapSeries>
Comments
0 comments
Please sign in to leave a comment.