Add Georeference To PDF Activity


The Add Georeference To PDF activity adds georeference metadata to a PDF document. This creates a geospatial PDF that allows the end user to interact with the PDF to access real world coordinates and measurements.


Given a PDF document containing a map image with known bounding coordinates, a workflow can apply those known coordinates as georeference metadata to the PDF. The activity produces a new PDF document. The Write File Bytes activity could write the new PDF to disk, or the Create Download activity could generate a URL to the new PDF so that an end user could download it. Finally the end user is able to use the geospatial features of their PDF viewer application to identify coordinates on the map and measure distances.




Type: String | Number[]

The source PDF document. Either a file path or byte content are accepted.

Bytes are the raw binary values that represent content. A byte array is represented by a list of numbers between 0 and 255. Invalid byte content will cause an error.

One way byte content can be retrieved is by using the Read File Bytes activity.

Page Bounds


Type: Number[][]

The bounding coordinates of the map element to georeference in PDF user space.

The array must contain two coordinate pairs in the following order: [[bottom-left x, bottom-left y], [top-right x, top-right y]]. The coordinate [0, 0] represents the bottom left corner of the page. Typically the units of a PDF are in points (1/72 of an inch).

Map Bounds


Type: Number[][]

The bounding coordinates of the map element to georeference in geographic space.

The array must contain four coordinate pairs in the following order: [[bottom-left latitude, bottom-left longitude], [top-left latitude, top-left longitude], [top-right latitude, top-right longitude], [bottom-right latitude, bottom-right longitude]].

Coordinate System


Type: String

The Well-Known Text (WKT) definition of the coordinate system of the map coordinates.

Page Index


Type: Number

The zero-based index of the page to apply the georeferenced metadata to. The default is 0.



Type: String

An optional name to apply to the georeference metadata. The default is "Map".



Type: Number[]

A new PDF document containing the specified georeference metadata.


For information about the ID, Display Name, and Description properties, see Properties Common to all Activities.

Connectivity Requirements

This activity does not work when the device has intermittent connectivity to the network.

See also...

Geospatial PDFs