The MapBook Creation tool allows you to create a TerraGo MapBook from GeoPDF files/geospatially-aware PDF files and a GeoPDF index map or from a map series file and a GeoPDF index map.

For instructions on how to access the MapBook Creation tool, see Accessing the GeoPDF Composer Toolbar.

In this document:

MapBook capabilities and requirements

If you do not have a map series file, create your TerraGo MapBook using GeoPDF files/geospatially-aware PDF files and a GeoPDF index map. The MapBook Creation tool automatically creates a map series file.

When you create a TerraGo MapBook, you must place all of the GeoPDF files/geospatially-aware PDF files or map series file in the same directory, and you must place the GeoPDF index map in that directory or in the directory directly above in the folder structure. To view a TerraGo MapBook in Google Earth, the coordinate systems associated with the PDF files to be included in the MapBook must be able to shift to WGS84.

You can replace existing files and add new files to your TerraGo MapBook at any time. You must have the GeoPDF index map to update your MapBook, and the index map must be in the same folder as the original MapBook. If you have modified the map series file associated with your MapBook and you want to maintain the custom label information, you should place the map series file in the same folder with the GeoPDF index map.

At any time you can customize the grid, hyperlink and bookmark settings in the map series file.

Creating a MapBook from GeoPDF/geospatially-aware PDF files and a GeoPDF index map

• From the GeoPDF Composer Toolbar, click the MapBook Creation tool.

• In the TerraGo MapBook dialog box, select Create a MapBook from GeoPDF files.

Specifying GeoPDF Toolbar compatibility

From the Verify GeoPDF Toolbar Compatibility list box, choose the GeoRegistration encoing method with which the PDF files should be compatible. The default value is the GeoRegistration encoding method you specified in the GeoRegistration Format Compatible With list box on the TerraGo Preferences dialog box. If you did not specify an encoding method, the default for the GeoRegistration Format Compatible With list box is GeoPDF Toolbar 3+ (OGC), which corresponds to OGC Only in the Verify GeoPDF Toolbar Compatibility list box.

OGC Only

• OGC Only requires that the maps to be included in the MapBook be encoded using the TerraGo GeoRegistration encoding that was published as an OGC best practice in 2008. The OGC best practice is the most widely distributed GeoRegistration encoding in terms of existing PDF libraries and workflows because GeoPDF was the only geospatial PDF available preceding the release of Acrobat 9.

• This option is useful if you know that all of the maps to be included in the MapBook were encoded using the OGC best practice and your users are running an older version of the GeoPDF Toolbar.

Mixed ISO and OGC

• Mixed ISO and OGC prefers that the maps to be included in the MapBook be encoded using the TerraGo GeoRegistration encoding method, but allows maps that have been encoded using the ISO 32000 GeoRegistration encoding method.

• This option is useful if the maps to be included in the MapBook have been encoded using either encoding method and your users are running multiple versions of the GeoPDF Toolbar.

ISO Only

• ISO Only requires that the maps to be included in the MapBook be encoded using the ISO 32000 GeoRegistration encoding method.

• This option is useful if you know that all of the maps to be included in the MapBook were encoded using Adobe's encoding method and your users are running a later version of the GeoPDF Toolbar.

Note: Adobe implemented a different PDF GeoRegistration encoding when it released Acrobat 9 and submitted that method to ISO as a proposed extension to ISO 32000. Both OGC and ISO GeoRegistration methods encode the same information; however, more coordinate systems are supported using Adobe's GeoRegistration encoding. TerraGo software is capable of reading and writing both encoding methods.

Selecting MapBook files

• Click Next.

• Click Browse to navigate to the folder in which the GeoPDF files/geospatially-aware PDF files reside.

• Select the files to be included in the map book and then click Open.

• Click Next.

• Click Browse to navigate to the folder in which the GeoPDF index map resides.

• Select the file and then click Open.

• Click Next.

Notes:

• To view the association between a GeoPDF index map and the individual GeoPDF files/geospatially-aware PDF files see About a GeoPDF Index Map and its GeoPDF Files.

• The user interface allows you to select your input files from only one directory. If your input files reside in more than one directory, you can define those directories by editing your map series file. If you do not have a map series file, select one input folder and then complete the map book creation process, which creates the map series file.

• To view a TerraGo MapBook in Google Earth, the coordinate systems associated with the PDF files to be included in the MapBook must be able to shift to WGS84.

Finishing the MapBook creation process

• Click Browse to open the Browse For Folder dialog box, then navigate to the location where the output files should be placed.

• Choose whether or not to check TerraGo Enable and enable the MapBook for comments and measuring/analysis in Adobe Reader, online connectivity, digital signing and other advanced permissions. The default option is whatever you specified in the Composer pane of the TerraGo Preferences dialog box. TerraGo Enabled MapBooks provide your users access to the GeoPDF GeoMark Toolbar, through which they can add points, polylines and polygons to a map. Users can also import, export and delete GeoMarks as well as create filters for viewing GeoMarks and manage peer-to-peer imports, exports and GeoForms.

• Click OK.

• Click Finish. A progress bar will appear at the bottom right corner of the application.

• At the Success message box, click Yes to view the log or No to close the message box.

Notes:

• If the output directory is the same as the location where the original files reside, the map book creation process overwrites the original files.

• If you want to customize the color, fill, font size, and more for the grid and hyperlinks in the output GeoPDF index map and throughout the TerraGo MapBook, see About Grid, Hyperlink and Bookmark Customization.

Creating a MapBook from a map series file and a GeoPDF index map

• From the GeoPDF Composer Toolbar, click the MapBook Creation tool.

• In the TerraGo MapBook dialog box, select Create a MapBook from a map series file.

Specifying GeoPDF Toolbar compatibility

From the Verify GeoPDF Toolbar Compatibility list box, choose the GeoRegistration encoing method with which the PDF files should be compatible. The default value is the GeoRegistration encoding method you specified in the GeoRegistration Format Compatible With list box on the TerraGo Preferences dialog box. If you did not specify an encoding method, the default for the GeoRegistration Format Compatible With list box is GeoPDF Toolbar 3+ (OGC), which corresponds to OGC Only in the Verify GeoPDF Toolbar Compatibility list box.

OGC Only

• OGC Only requires that the maps to be included in the MapBook be encoded using the TerraGo GeoRegistration encoding that was published as an OGC best practice in 2008. The OGC best practice is the most widely distributed GeoRegistration encoding in terms of existing PDF libraries and workflows because GeoPDF was the only geospatial PDF available preceding the release of Acrobat 9.

• This option is useful if you know that all of the maps to be included in the MapBook were encoded using the OGC best practice and your users are running an older version of the GeoPDF Toolbar.

Mixed ISO and OGC

• Mixed ISO and OGC prefers that the maps to be included in the MapBook be encoded using the TerraGo GeoRegistration encoding method, but allows maps that have been encoded using the ISO 32000 GeoRegistration encoding method.

• This option is useful if the maps to be included in the MapBook have been encoded using either encoding method and your users are running multiple versions of the GeoPDF Toolbar.

ISO Only

• ISO Only requires that the maps to be included in the MapBook be encoded using the ISO 32000 GeoRegistration encoding method.

• This option is useful if you know that all of the maps to be included in the MapBook were encoded using Adobe's encoding method and your users are running a later version of the GeoPDF Toolbar.

Note: Adobe implemented a different PDF GeoRegistration encoding when it released Acrobat 9 and submitted that method to ISO as a proposed extension to ISO 32000. Both OGC and ISO GeoRegistration methods encode the same information; however, more coordinate systems are supported using Adobe's GeoRegistration encoding. TerraGo software is capable of reading and writing both encoding methods.

Selecting MapBook files and creating the MapBook

• Click Next.

• Click Browse to navigate to the folder in which the map series definition file is located.

• Select the file and then click Open.

• Click Next.

• Click Browse to navigate to the folder in which the GeoPDF index map is located.

• Select the file and then click Open.

• Click Next.

• Click Browse to open the Browse For Folder dialog box, then navigate to the location where the output files should be placed.

• Click OK.

• Click Finish. A progress bar will appear at the bottom right corner of the application.

• At the Success message box, click Yes to view the log or No to close the message box.

Notes:

• To view the contents of a map series file, see About Map Series Files.

• If you want to customize the color, fill, font size, and more for the grid and hyperlinks in the output GeoPDF index map and throughout the TerraGo MapBook, see About Grid, Hyperlink and Bookmark Customization.

Extracting a map series file from a GeoPDF index map

• From the GeoPDF Composer Toolbar, click the MapBook Creation tool.

• In the TerraGo MapBook dialog box, select Extract a map series file from a GeoPDF index map.

Specifying GeoPDF Toolbar compatibility

From the Verify GeoPDF Toolbar Compatibility list box, choose the GeoRegistration encoing method with which the PDF files should be compatible. The default value is the GeoRegistration encoding method you specified in the GeoRegistration Format Compatible With list box on the TerraGo Preferences dialog box. If you did not specify an encoding method, the default for the GeoRegistration Format Compatible With list box is GeoPDF Toolbar 3+ (OGC), which corresponds to OGC Only in the Verify GeoPDF Toolbar Compatibility list box.

OGC Only

• OGC Only requires that the maps to be included in the MapBook be encoded using the TerraGo GeoRegistration encoding that was published as an OGC best practice in 2008. The OGC best practice is the most widely distributed GeoRegistration encoding in terms of existing PDF libraries and workflows because GeoPDF was the only geospatial PDF available preceding the release of Acrobat 9.

• This option is useful if you know that all of the maps to be included in the MapBook were encoded using the OGC best practice and your users are running an older version of the GeoPDF Toolbar.

Mixed ISO and OGC

• Mixed ISO and OGC prefers that the maps to be included in the MapBook be encoded using the TerraGo GeoRegistration encoding method, but allows maps that have been encoded using the ISO 32000 GeoRegistration encoding method.

• This option is useful if the maps to be included in the MapBook have been encoded using either encoding method and your users are running multiple versions of the GeoPDF Toolbar.

ISO Only

• ISO Only requires that the maps to be included in the MapBook be encoded using the ISO 32000 GeoRegistration encoding method.

• This option is useful if you know that all of the maps to be included in the MapBook were encoded using Adobe's encoding method and your users are running a later version of the GeoPDF Toolbar.

Note: Adobe implemented a different PDF GeoRegistration encoding when it released Acrobat 9 and submitted that method to ISO as a proposed extension to ISO 32000. Both OGC and ISO GeoRegistration methods encode the same information; however, more coordinate systems are supported using Adobe's GeoRegistration encoding. TerraGo software is capable of reading and writing both encoding methods.

Selecting MapBook files and creating the MapBook

• Click Next.

• Click Browse to navigate to the folder in which the GeoPDF index map is located.

• Select the file and then click Open.

• Click Next.

• Click Browse to open the Browse For Folder dialog box, then navigate to the location where the output files should be placed.

• Click OK.

• Click Finish.

• A message box appears letting you know the CSV Export has finished. Click OK.

Note: If you want to customize the color, fill, font size, and more for the grid and hyperlinks in the output GeoPDF index map and throughout the TerraGo MapBook, see About Grid, Hyperlink and Bookmark Customization.

Updating an existing MapBook

• From the GeoPDF Composer Toolbar, click the MapBook Creation tool.

• In the TerraGo MapBook dialog box, select the Update existing MapBook.

Identifying the map file type

• Select Update GeoPDF index map if you would like updates to be made to your existing GeoPDF index map.

• Select Update tile adjacencies if you would like updates to adjacency hyperlinks to be made to your MapBook's GeoPDF files.

• Select Use existing map series file if you would like to use an existing map series file to represent the files and values for your GeoPDF index map labels and hyperlinks.

Specifying GeoPDF Toolbar compatibility

From the Verify GeoPDF Toolbar Compatibility list box, choose the GeoRegistration encoing method with which the PDF files should be compatible. The default value is the GeoRegistration encoding method you specified in the GeoRegistration Format Compatible With list box on the TerraGo Preferences dialog box. If you did not specify an encoding method, the default for the GeoRegistration Format Compatible With list box is GeoPDF Toolbar 3+ (OGC), which corresponds to OGC Only in the Verify GeoPDF Toolbar Compatibility list box.

OGC Only

• OGC Only requires that the maps to be included in the MapBook be encoded using the TerraGo GeoRegistration encoding that was published as an OGC best practice in 2008. The OGC best practice is the most widely distributed GeoRegistration encoding in terms of existing PDF libraries and workflows because GeoPDF was the only geospatial PDF available preceding the release of Acrobat 9.

• This option is useful if you know that all of the maps to be included in the MapBook were encoded using the OGC best practice and your users are running an older version of the GeoPDF Toolbar.

Mixed ISO and OGC

• Mixed ISO and OGC prefers that the maps to be included in the MapBook be encoded using the TerraGo GeoRegistration encoding method, but allows maps that have been encoded using the ISO 32000 GeoRegistration encoding method.

• This option is useful if the maps to be included in the MapBook have been encoded using either encoding method and your users are running multiple versions of the GeoPDF Toolbar.

ISO Only

• ISO Only requires that the maps to be included in the MapBook be encoded using the ISO 32000 GeoRegistration encoding method.

• This option is useful if you know that all of the maps to be included in the MapBook were encoded using Adobe's encoding method and your users are running a later version of the GeoPDF Toolbar.

Note: Adobe implemented a different PDF GeoRegistration encoding when it released Acrobat 9 and submitted that method to ISO as a proposed extension to ISO 32000. Both OGC and ISO GeoRegistration methods encode the same information; however, more coordinate systems are supported using Adobe's GeoRegistration encoding. TerraGo software is capable of reading and writing both encoding methods.

Identifying map series files

• Click Next.

• If you chose Use existing map series file, click Browse to navigate to the folder in which the map series file is located.

• Select the file and then click Open.

Identifying other map files

• Click Next

• Click Browse to navigate to the folder in which the GeoPDF index map resides.

• Select the file and then click Open.

• Click Next.

• Click Browse to navigate to the folder in which the updated GeoPDF files/geospatially-aware PDF files are located.

• Select the files to be included in the MapBook and then click Open.

• Verify that all update files, adjacent files, update files that are Reader Enabled and adjacent files that are Reader Enabled can successfully be included in the MapBook.

• If you make any changes and need to perform the verification again, click Back, then click Next again to refresh the dialog box.

Notes:

• The updated GeoPDF files/geospatially-aware PDF files must reside in a directory outside of the current MapBook directory. These files cannot be located in the directory with the existing MapBook files or in a subdirectory of the existing MapBook files.

• To view a TerraGo MapBook in Google Earth, the coordinate systems associated with the PDF files to be included in the MapBook must be able to shift to WGS84.

• If your GeoPDF index map contains references to files that do not reside in either the update or output folders, the MapBook Creation tool will complete the update process but displays an error message specific to the missing file. If there are multiple missing files, the error message appears only for the first missing file encountered. This same error message appears again when you click Finish at the end of the process.

Creating the MapBook

• When you are satisfied with the results preview, click Finish.

• At the Success message box, click Yes to view the log or No to close the message box.

Grid, Hyperlink, and Bookmark Customization

You can customize the color, fill, font size, and more for the grid and hyperlinks in the output GeoPDF index map and throughout the TerraGo MapBook by editing the sample griddefaults.xml and linksplacer.xml files.

The griddefaults.xml and linksplacer.xml files are located in the C:\Program Files\TerraGo Technologies\GeoPDF Composer\acrokit folder on the machine where TerraGo Composer is installed. After you customize the two .xml files you must copy the files to the directory where the GeoPDF files, the geospatially-aware PDF files, or the map series definition file and the GeoPDF index map are located for your customizations to affect the output.

Customizing the griddefaults.xml file

Note: The <default> element must be present.

<PolygonStyle>:

<PathStyle>:

<LabelStyle>:

Customizing the linksplacer.xml file

The <Link> element must be present and contains the following options:

<LinkPlacement> attributes: