Creating a GeoJSON geography

concept brazil Updated Sep 10, 2026 3 min read creating-a-gojson-geography.md
Raw file servicenow.com

Create a GeoJSON geography by importing GeoJSON co-ordinates or drawing shapes directly on the map.

Create a GeoJSON geography

Create a GeoJSON geography to define territory boundaries with polygons, multipolygons, or circles.

Before you begin

The GeoJSON must meet the format requirements. For more information, see GeoJSON format requirements for territory geographies.

Role required: sn_fsm_tp.fsm_territory_planner, sn_fsm_tp.territory_manager

About this task

Use GeoJSON geography type to accommodate scenarios where detailed geo-spatial information is available externally, enabling organizations to incorporate diverse geographic datasets into the planning processes.

Note: For accurate task assignments with Schedule Optimization, use consistent shapes, such as polygons or circles, and avoid overlapping or intersecting geographies.

Procedure

  1. Navigate to All > Field Service > Territory Planning > Territory Geography.

  2. On the Territory Geographies page, select New.

  3. On the form, fill in the fields.

    Field Description
    Name Name of the geography.
    Geography Type Type of geography. Select GeoJSON.
    GeoJSON GeoJSON content that defines the geography. Supported geometry types are Polygon, MultiPolygon, and Point (circle). For format requirements, see GeoJSON format requirements for territory geographies.
  4. Select Submit.

    The geography of type GeoJSON is created based on the given coordinates.

Result

After you link the geography to a territory, the territory appears in the Territories related list of the geography record. The GeoJSON geography appears on the map when you select its territory in the Territory Planning console.

What to do next

Link the geography to a territory. For more information, see Create a Field Service territory.

Create a GeoJSON geography in Territory Planning console

Draw boundaries on the map to define your geographic areas and create GeoJSON geographies. These geographies not only give you a clear visual on the map but also used task scheduling.

Before you begin

Role required: sn_fsm_tp.fsm_territory_planner

About this task

Allows you to interactively draw shapes such as polygons or circles directly on the map, streamlining the process of creating territories for effective task assignment. If necessary, you can create a multi polygon based geography by drawing multiple polygons on the map. For example, if the geographic area for a territory comprises water and land, you can select multiple land areas spread across the water body to define a territory geography.

Note: For effective task assignments using Schedule Optimization, it is recommended to use consistent shapes (like polygons or circles) and avoid overlapping or intersecting geographies to ensure accurate results.

Procedure

  1. Navigate to All > Field Service > Territory Planning > Territory Planning Console.

  2. In the Territories panel, select Create Territory.

    The Create New Territory page appears.

  3. In the Geography field, select the New Geography for Territory icon ([Omitted image "EditWidgetButton.png"] Alt text: New Geography for Territory icon.) to draw a geography.

  4. Select the drawing method.

    • To draw a geography using an existing territory, choose Draw using territory and select the desired territory from the list in the Territories panel.
    • To search for an area on the map, by entering a location in the Search address bar, select Draw on map. Note: To create a geography based on the presence of resources (Agents, Crews, or Assets), select the desired resources from the overlay options displayed on the map.
  5. Select the drawing tool.

    • To draw a boundary area or multiple areas, use the polygon shape icon ([Omitted image "Polygon-shape.png"] Alt text: Draw a shape icon.).
    • To define a geography with a specific radius, use the circle shape icon ([Omitted image "Circle-shape.png"] Alt text: Draw a circle icon.).
  6. In the Name field, enter the name for the geography.

    A GeoJSON script is automatically generated.

  7. Click Save.

    The GeoJSON geography is created based on the selected area on the map.

Result

After creating a GeoJSON geography, connect it to a territory for work order management; the associated territory will be listed in the Territories related list when you open the geography record. The geography appears visually on the map when its territory is selected in the Territory Planning console.

What to do next

Link the geography to a territory. For more information, see Create a Field Service territory.

Search documentation
Search document titles and file paths on the brazil branch