Welcome to the TerraGo Customer Center

Articles in this section

Map Definition Files

Avatar
TerraGo Support
  • Updated
Follow

A map definition file contains the coordinate pairs of the four corners of each PDF file or geospatially-aware PDF file to be GeoRegistered. The map definition file can be in .csv or .xml file format.

In this document:

Fields in a map definition .csv file

The following fields appear in a map definition file in .csv file format:

Name

Type

Description

PDF

File

The path to the PDF file to be GeoRegistered (MANDATORY)

Page

Integer

The page number of the map in the PDF file; the first page is 1 and is the default value (OPTIONAL)

Description

String

The name or description of the map frame; the default value is the base name of the PDF file (OPTIONAL)

Template

File

The name or description of the map frame; the default value is the base name of the PDF file (OPTIONAL)

TPage

Number

The page number of the template GeoPDF file; the default value is 1 (OPTIONAL)

TMF

Number

The map frame number to use as a template; the default value is 0, which is the largest map frame in the GeoPDF space (OPTIONAL)

The first coordinate pair must begin in the lower left corner and proceed clockwise.

X1

Number

The first map coordinate X (MANDATORY)

Y1

Number

The first map coordinate Y (MANDATORY)

X2

Number

The second map coordinate X (MANDATORY)

Y2

Number

Number – The second map coordinate Y (MANDATORY)

X3

Number

The third map coordinate X (MANDATORY)

Y3

Number

The third map coordinate Y (MANDATORY)

Xn

Number

The nth map coordinate X (MANDATORY)

Yn

Number

The nth map coordinate Y (MANDATORY)

Sample .csv map definition file

The sample below is a map definition 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.

A01.pdf|1|Description A01|template.pdf|1|-1|500000|3003276|500000|3003744|500648|3003744|500648|3003276
A02.pdf|1|Description A02|template.pdf|1|-1|500648|3003276|500648|3003744|501296|3003744|501296|3003276
B01.pdf|1|Description B01|template.pdf|1|-1|502592|3003276|502592|3003744|503240|3003744|503240|3003276
B02.pdf|1|Description B02|template.pdf|1|-1|503240|3003276|503240|3003744|503888|3003744|503888|3003276
C01.pdf|1|Description C01|template.pdf|1|-1|500000|3001404|500000|3001872|500648|3001872|500648|3001404
C02.pdf|1|Description C02|template.pdf|1|-1|500648|3001404|500648|3001872|501296|3001872|501296|3001404
D01.pdf|1|Description D01|template.pdf|1|-1|502592|3001404|502592|3001872|503240|3001872|503240|3001404
D02.pdf|1|Description D02|template.pdf|1|-1|503240|3001404|503240|3001872|503888|3001872|503888|3001404

Sample .xml map definition file

<?xml version='1.0' encoding='UTF-8' ?>
<MapDescription xmlns='http://ns.terragotech.com/mapdescription/1.0'>
  <Maps type='array'>
    <Map type='dictionary'>
      <Type Value='Map' type='name' />
      <PDF Value='A01.pdf' type='string' />
      <PageIndex Value='1' type='integer' />
      <TemplateMapframe type='dictionary'>
        <Type Value='TemplateMapframe' type='name' />
        <PDF Value='template.pdf' type='string' />
        <PageIndex Value='1' type='integer' />
        <MapframeIndex Value='-1' type='integer' />
      </TemplateMapframe>
      <Mapframes>
        <Mapframe type='dictionary'>
          <Type Value='Mapframe' type='name' />
          <Description Value='Description A01' type='string' />
          <Neatline type='array'>
            <Dict>
              <Type Value='Point' type='name' />
              <Subtype Value='Map' type='name' />
              <x Value='500000' type='string' />
              <y Value='3003276' type='string' />
            </Dict>
            <Dict>
              <Type Value='Point' type='name' />
              <Subtype Value='Map' type='name' />
              <x Value='500000' type='string' />
              <y Value='3003744' type='string' />
            </Dict>
            <Dict>
              <Type Value='Point' type='name' />
              <Subtype Value='Map' type='name' />
              <x Value='500648' type='string' />
              <y Value='3003744' type='string' />
            </Dict>
            <Dict>
              <Type Value='Point' type='name' />
              <Subtype Value='Map' type='name' />
              <x Value='500648' type='string' />
              <y Value='3003276' type='string' />
            </Dict>
          </Neatline>
        </Mapframe>
      </Mapframes>
    </Map>
  </Maps>
</MapDescription>

Comments

0 comments

Please sign in to leave a comment.