Prepare geometry

Supported in: Batch, Streaming

Prepares a geometry for downstream use, for example indexing to the ontology, by converting a geometry string into valid GeoJSON. Polygons will be closed and deduplicated. Geometries which cross the anti-meridian (as indicated by width > 180 degrees) will be split into multiple features on each side of the anti-meridian. By default, this operation will return the converted geometry, or null if the string cannot be converted. Alternatively, in the "show errors" output mode, this operation will instead output a struct containing either the successfully parsed output or a descriptive error message.

Expression categories: Geospatial

Declared arguments

• Geometry string - Geometry string to be parsed and converted to GeoJSON.
  Expression<String>
• optional Output mode - Choose to output as a simple output where the output is the resulting geometry and errors are returned as null, or output a struct with two fields: an "ok" field with the resulting geometry if it can be converted; otherwise, an "error" field containing a descriptive error message.
  Enum<Simple, With errors>

Output type: Geometry | Struct<ok, error>

Examples

Example 1: Base case

Argument values:

• Geometry string: geometry
• Output mode: null

---

Example 2: Base case

Argument values:

• Geometry string: geometry
• Output mode: null

---

Example 3: Base case

Argument values:

• Geometry string: geometry
• Output mode: null

---

Example 4: Null case

Argument values:

• Geometry string: geometry
• Output mode: with_errors

---

Example 5: Null case

Argument values:

• Geometry string: geometry
• Output mode: null

---

Example 6: Edge case

Argument values:

• Geometry string: geometry
• Output mode: null

---

Example 7: Edge case

Argument values:

• Geometry string: geometry
• Output mode: null

---

Example 8: Edge case

Argument values:

• Geometry string: geometry
• Output mode: null

---