Add Georeference To PDF Activity

Description

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.

Usage

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.

Inputs

Source

Required

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

Required

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

Required

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

Required

Type: String

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

Page Index

Optional

Type: Number

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

Name

Optional

Type: String

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

Outputs

result

Type: Number[]

A new PDF document containing the specified georeference metadata.

Properties

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.