GeoJSON Formatting Guide for Locations (Beta)

Background

In Beta

This feature is currently in closed beta for select Procore customers.

The Locations tool allows you to define specific geographic areas for your project. While you can draw directly on the map, pasting GeoJSON code provides a precise way to create complex geometries like lines and polygons. Ensuring your coordinates are formatted correctly prevents parsing errors and ensures your project locations appear exactly where they should.

Things to Consider

  • Required User Permissions:

    • 'Read Only' level permissions or higher on the project's Maps tool.

    • 'Admin' level permissions on the project's Locations tool.

    • See Required User Permissions.

  • To bulk-import locations with GIS coordinates via Procore Imports:

    • 'Admin' level permissions on the Project Admin tool, OR

    • 'Admin' level permissions on the project's Locations tool.

  • Coordinate Standards:

    • Coordinates must use the latitude and longitude system. Other systems, such as UTM, are not supported.

      • Only coordinates where the latitude value comes first are accepted.

    • Coordinates must be in Decimal Degrees (for example, 40.7128 or -74.006).

    • Do not use text characters or symbols like 40° 43' 50.1960'' N or 74.0060° W, as Procore cannot scan them.

    • Enter coordinates by copying and pasting them as a single text string, whether you are adding a single point or an array of coordinates for a line or polygon.

  • Procore Imports Template Validation:

    • When populating the GIS Coordinates column in the Locations Procore Imports template, the system validates coordinates during processing. Any invalid geometry, including unclosed polygon loops or formatting syntax errors, will be flagged as an import error.

Note

In the context of Decimal Degrees (DD), which is the standard format used by GPS devices and web maps like Google Maps, the ranges are expressed as simple positive or negative numerical values:

Latitude

  • Range: -90.000000 to 90.000000

  • Positive values (+): Represent locations North of the Equator.

  • Negative values (-): Represent locations South of the Equator.

  • Example: Austin, TX is approximately 30.2672.

Longitude

  • Range: -180.000000 to 180.000000

  • Positive values (+): Represent locations East of the Prime Meridian.

  • Negative values (-): Represent locations West of the Prime Meridian.

  • Example: Austin, TX is is approximately -97.7431.

Formatting Guide

Map Geometry Type

Format

Example

Notes

Point

Latitude, Longitude

47.949531, -122.300606

Represents a single discrete location point.

Line

[Latitude, Longitude], [Latitude, Longitude], …

[47.949245, -122.299034],

[47.949884, -122.296480]

Represents a LineString path. This type requires at least 2 coordinate pairs to be valid.

Polygon

[[Latitude, Longitude], [Latitude, Longitude], …]]

[[47.949800, -122.301423],

[47.949749, -122.301481],

[47.949711, -122.301367],

[47.949769, -122.301366],

[47.949800, -122.301423]]

Requires a closed coordinate loop. The first and last coordinate pairs must be identical (forming at least 3 distinct boundary vertices plus the closing point). Geometries without closed loops are invalid and will fail import validation.

See Also

Loading related articles...