|Introduction | Sustainability Factors | Content Categories | Format Descriptions | Contact|
|Full name||GeoPDF File Format (TerraGo)|
GeoPDF® is a trademark registered to TerraGo Technologies, Inc. [Serial #: 78655318]. TerraGo insists that the term GeoPDF should be reserved for files created by TerraGo products; this description covers such files. See What is GeoPDF? and GeoPDF Products from TerraGo. TerraGo does not provide a detailed specification but claims compliance with existing documentation for PDF as specified in ISO 32000. There are two versions of this international standard, published as Parts 1 and 2 of ISO 32000:
The compilers of this resource have not yet located any GeoPDF files that have the new version designation defined in PDF 2.0, %PDF–2.0. Comments welcome.
TerraGo's GeoPDF products are designed to facilitate sharing complex multi-layer maps and imagery to provide easy access and geospatial collaboration capabilities to non-GIS professionals. A press release in March 2020 for an update to TerraGo's main authoring tool for GeoPDFs, stated, "GeoPDF documents made with TerraGo Publisher for ArcGIS can be used with the TerraGo Toolbar. They also can be extended to Adobe Acrobat Reader to provide a host of GIS-lite capabilities. These capabilities include an Identify Tool, simultaneous display of multiple geographic coordinates, measurement and geospatial markup." A GeoPDF MapBook Help Page from the Missouri National Guard shows the functionality of the Toolbar in 2010. The TerraGo Toolbar, renamed the GeoPDF Toolbar later in 2020, is a freely downloadable add-on to Adobe Acrobat Reader available for the Microsoft Windows operating system. There is no documentation available to specify exactly how Terrago uses structures specified in ISO 32000 to implement features supported by the GeoPDF Toolbar. Some indications can be gleaned from: TerraGo Publisher for ArcGIS Server - Automation with PubPy. PubPy is a Python software library that allows an Esri ArcGIS Server to be programmed to "create on-demand GeoPDFs containing maps and imagery embedded with your intelligence and data." TerraGo offers a GeoPDF® Software Development Kit (SDK) but has no associated public documentation.
In addition to complying with ISO 32000, a GeoPDF file must incorporate one of two supported georegistration encodings:
A primary intended functionality of georegistration is to support calculation of the position in coordinates of any point on a map image and thus to associate PDF annotations and linked files with a particular geospatial location and to support measurement between points. Point locations can be expressed in any coordinate reference system and the two supported encodings include sufficient information to perform conversions between coordinate systems. The OGC and ISO georegistration methods both encode the same information; however, more coordinate systems are supported using the ISO georegistration encoding. See lists of coordinate systems provided by TerraGo at OGC Projections and Datums and ISO Projections and Datums. TerraGo software is capable of reading and writing both encoding methods.
In his February 2009 blog post, OGC Approves GeoPDF 2.2 as OGC Best Practice, George Demmy of TerraGo recommended, "If you'd like to roll-your-own geospatial PDF, I'd recommend using Adobe's proposed geospatial extensions to ISO 32000. Our software supports this georegistration technique, and we're already moving in that direction." The compilers of this resource have not attempted to determine the relative adoption of the two approaches to georegistration in GeoPDF documents. Comments welcome.
TerraGo's GeoPDF Publisher for ArcGIS and GeoPDF Composer offer three compatibility options related to georegistration:
|Relationship to other formats|
|Subtype of||PDF_family, Portable Document Format|
|May contain||PDF_1_7_geospatial, PDF, Version 1.7, ExtensionLevel 3, Geospatial Encoding (Adobe). A GeoPDF file must incorporate georegistration. The encoding for georegistration first published by Adobe in PDF 1.7, ExtensionLevel 3, has been incorporated into ISO 32000-2 and is one of two options for GeoPDF files.|
|May contain||GeoPDF_OGC, GeoPDF Encoding (TerraGo 2.2), OGC Best Practice. A GeoPDF file must incorporate georegistration. The encoding developed by TerraGo for georegistration was published as a best practice by the Open Geospatial Consortium (OGC) in 2009 and is one of two options for GeoPDF files.|
|May contain||GeoPackage_family, GeoPackage Encoding Standard (OGC) Format Family|
|LC experience or existing holdings||The compilers of this resource are not currently able to determine how many GeoPDF files have been added to the Library of Congress collections. A set of USGS Quadrangle maps in this format was acquired in 2012.|
|LC preference||The Library of Congress Recommended Formats Statement (RFS) designates GeoPDF as an "acceptable" format for GIS Vector and Raster Combined content for GIS, Geospatial and Non-GIS Cartographic collections. The RFS does not specify a version of GeoPDF file format or a preferred PDF georegistration within GeoPDF files.|
There is no detailed documentation on how TerraGo software uses the capabilities of PDF to support the functions of the TerraGo GeoPDF Toolbar.
TerraGo states that GeoPDF files created by its software (stand-alone products or libraries or toolkits that it licenses for integration into products from other vendors, such as Esri or BAE) comply with one of the two ISO 32000 international standards for PDF and use one of two publicly documented georegistration encodings.
According to TerraGo, a GeoPDF file will comply with one of these PDF specifications:
and use one of these georegistration encoding mechanisms:
TerraGo Technologies has worked with Esri, other vendors, and customers, to develop a suite of software tools that create GeoPDF files and support their use; in particular, these files can be used in the field via the GeoPDF Toolbar or TerraGo Edge apps for iOS or Android mobile devices to check existing data about equipment items, land parcels, etc. and add annotations in the field that can be fed back into a GIS database. See TerraGo releases GeoPDF Software Suite Version 7.0 and GeoPDF® Products. The main products for creating GeoPDF documents are GeoPDF Publisher, available as an extension for ArcGIS Pro, and GeoPDF Composer, an extension for Adobe Acrobat. A GeoPDF Software Development Kit (SDK) is also available. GeoPDF Toolbar is a free plug-in for Adobe Reader that allows anyone to access, update and share GeoPDF maps and imagery; its functionality is often described as "GIS-lite."
Some GIS software vendors support integration of TerraGo modules into their products and can therefore generate GeoPDF files. For example, add-ons for Esri products include GeoPDF Publisher for ArcGIS Pro and GeoPDF Publisher for ArcGIS Server. BAE Systems has integrated TerraGo 2D GeoPDF Publisher into its SOCET GXP product. Many GIS applications can import and display GeoPDF files and extract layers or convert a GeoPDF map to another format but are not able to reproduce the advanced functionality of the GeoPDF Toolbar.
Several U.S. government agencies have produced and distributed maps as GeoPDF files, including the U.S. Army Corps of Engineers, and the National Geospatial-Intelligence Agency. For example, see:
Starting in 2009, the United States Geological Survey (USGS) began to publish two new map products in digital form. The first product was an end product of a digital workflow for generating the equivalent of standard USGS printed maps at 1:24,000, known as US Topo maps. The second product was for scanned versions of USGS Historical Topographic Quadrangle maps, dating back to 1884. Both products initially used Terrago GeoPDF files as a format for distribution of digital maps for public use. In 2017, the current US Topo maps were migrated to specifications based on the ISO 32000 encoding for georegistration (see PDF_1_7_geospatial) as introduced with Acrobat 9.0 in June 2008. For the file specifications from USGS, see http://pubs.usgs.gov/tm/tm11b2/ for the US Topo Product Standard and https://pubs.er.usgs.gov/publication/tm11B03 for the Standard for the U.S. Geological Survey Historical Topographic Map Collection (HTMC). The HTMC collection continues to use GeoPDF files with the OGC encoding for georegistration.
The GeoPDF format is a key component in several projects and partnerships in specific domains where TerraGo is developing software to support field operations. One active domain is management of street lighting by municipalities. See for example, TerraGo Streetlights; TerraGo and Urban Control partner for intelligent street lighting, and Itron Signs Global Reseller Agreement with TerraGo to Accelerate Smart Streetlight Projects. Another domain is management of equipment assets by utilities. See for example, TerraGo Smart Utilities and Arrow 100 for Pipeline Data Collection: Enmapp Saves Thousands by Switching to TerraGo Edge with Eos.
The GeoPDF format is accepted by the National Library of Australia for legal deposit. See What file format should I deposit?.
|Licensing and patents||
GeoPDF is a registered trademark of TerraGo Technologies, Inc. with serial number 78655318. See https://uspto.report/TM/78655318 for details and history. With relation to the georegistration encoding published as a Best Practice by Open Geospatial Consortium, OGC 08-139r3 includes the statement, "This specification is being provided by TerraGo on a reasonable and non-discriminatory, royalty free basis (RAND-RF)."
See PDF_family for patent and licensing information associated with PDF.
|Transparency||Depends upon compliant software tools to read. Building tools requires sophistication. In practice, most PDFs have compression filters applied to most of the file content. Image compression depends on underlying image format and options chosen when GeoPDF is created. Vector layers can also be compressed; see Vector Options in GeoPDF Publisher knowledge base.|
|Self-documentation||A GeoPDF file must have georegistration information, providing limited geospatial metadata for maps or other georegistered illustrations in a PDF file, sufficient to support geolocation and measurement. Since the GeoPackage format has had a registered extension for Metadata since GeoPackage 1.1, it is possible that GeoPDF files can include metadata complying with ISO 19115 using that mechanism. ISO 19115 has been endorsed by FGDC (U.S. Federal Geographic Data Committee). According to TerraGo's presentation at the 13th Geospatial PDF Working Group – U.S. Federal Government meeting on August 5, 2020, the company is developing new capabilities for embedding metadata into GeoPDF files. See PDF_family for information on embedding metadata in PDF documents in general.|
A GeoPDF file must be created with a software product or tool developed by TerraGo. See GeoPDF Products.
Users of GeoPDF files who do not have a full GIS system that supports GeoPDF files need the TerraGo Toolbar, an add-on to Adobe Reader, to get full value from a GeoPDF file. The toolbar is freely downloadable (after registration), but works only on Windows. For mobile devices, there is the TerraGo Edge app; this app is designed for data capture in the field, but can also be used as a viewer for GeoPDF maps. See TerraGo Edge 4 on Apple's App Store and on Google Play.
|Technical protection considerations||Since GeoPDF files are PDF files, they can be protected using techniques available in Adobe Acrobat, for example, using passwords or certificates. They can also be encrypted using generic tools for encrypting individual files.|
|Normal rendering||See PDF_family for discussion of quality and functionality factors for images in PDF documents.|
|Clarity (high image resolution)||TerraGo's GeoPDF Publisher for ArcGIS Pro uses a default of 300 dpi for image resolution, but optionally supports much higher resolution when creating a GeoPDF. A table in Understanding Output Resolution has a column for 6400 dpi. Color bit depth will depend on source image type and characteristics. Color space options are RGB and CMYK. See documentation in TerraGo Publisher for ArcGIS Server - Automation with PubPy.|
|Color maintenance||See PDF_family.|
|Support for vector graphics, including graphic effects and typography||Excellent support for vector graphics and symbology in vector layers.|
|Support for multispectral bands||See PDF_family.|
|Functionality beyond normal rendering||A GeoPDF file is always georegistered and can contain multiple layers.|
|GIS images and datasets|
TerraGo often refers to features supported in its GeoPDF Toolbar as providing "GIS-lite" functionality. The overview page from TerraGo for GeoPDF Toolbar lists some of the functionality supported. Video demos of the Toolbar functionality are available at How to use a GeoPDF from 2016 and Toolbar Tutorial Webinar from 2020.
|Beyond normal functionality||
A GeoPDF file can contain GeoMarks, points or areas marked on a map and associated with data, including stamps (icons with specific meaning), notes, photos, video and other multimedia. If the GeoMark Enable setting was turned on by the creator of a GeoPDF, GeoMarks can be entered or editid by crew in the field using the GeoPDF Toolbar, to document an incident, update inventory, etc. If the creator so chooses, GeoMarks can be completed in the field with the help of a form embedded in the GeoPDF. GeoMarks can be exported as shapefiles or in KML for efficient sharing among field operators or transmission to headquarters over low bandwidth networks. They can also be exported into a TerraGo proprietary file format known as TWZ and called a TerraGo Collaboration Package. See How do I view my GeoMarks in Google Earth or other systems? and GeoPDF Toolbar Tutorial. Note that TerraGo's GeoPDF Toolbar is distributed with an associated GeoMark Toolbar. The GeoPDF Toolbar is primarily used for working with existing information in a GeoPDF, whereas the GeoMark Toolbar is used, if GeoMarks are enabled, for adding or editing data attached to the GeoPDF and its use will modify the GeoPDF. Comments welcome.
A GeoPDF file can contain a mapbook, i.e, a collection of related maps, typically including an index map that provides access to the individual map pages. A special feature of GeoPDF mapbooks is that you can move seamlessly from one map to the next based on geospatial location. See TerraGo Products: GeoPDF Composer and video demos at TerraGo Composer: GeoPDF Mapbook Intro and Overview and TerraGo Composer: How to Create a GeoPDF Mapbook. A webinar that has a section on creating a mapbook is available at Composer Tutorial Webinar.
|Internet Media Type||See note.||See PDF_family.|
|Magic numbers||See note.||See PDF_family.|
|Pronom PUID||See note.||No PUID as of August 2020.|
|Wikidata Title ID||Q5533911
||See https://www.wikidata.org/wiki/Q5533911 for GeoPDF as "file format extending PDF to allow for embedding georegistration information for maps".|
Terminology: This is an attempt to clarify some sources of confusion over terminology in the context of adding geospatial functionality to PDF documents.
The origin of GeoPDF files was at Layton Graphics, Inc. in 1999. The mapping group of Layton Graphics was spun off as TerraGo Technologies in September 2005. By this time, the term GeoPDF was in use for files created by a tool from TerraGo named MAP2PDF. See, for example, a March 25, 2005 press release from Layton Graphics. Application for registration of GeoPDF as a trademark was in June 2005. For more details, see History of GeoPDF: PDF Map Books, LGIView, and LGIDict (May 2009) and Layton Graphics forms TerraGo Technologies (September 2005).
For details on the history of the original georegistration encoding used in GeoPDF files, starting around 2003, and published in 2009 by the Open Geospatial Consortium (OGC) as Best Practice OGC 08-139r, see GeoPDF_OGC. With the release of Acrobat 9.0 in June 2008, Adobe published the specification of ExtensionLevel 3, including the specification for georegistration that has beemn incorporated into ISO 32000.