GeoMark Web Service REST API

Name: GeoMark Web Service REST API API
Brand: GeoMark Web Service REST API
Availability: InStock

✓ Official Vendor SpecMaps GeolocationMappingnone7 EndpointsREST

For Agents

Create reusable geographic areas of interest and serve them in multiple file formats and coordinate systems for cross-tool sharing.

Connect the GeoMark Web Service REST API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the GeoMark Web Service REST API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Install Jentic One Beta (Self-Hosted)

Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with GeoMark Web Service REST API API.

Create a geomark from supplied geometry to share an area of interest

Copy an existing geomark to derive a new shareable resource

Retrieve a geomark in JSON, GeoJSON, KML, or shapefile format

Retrieve only the bounding box of a geomark for quick map framing

GET STARTED

Start building with GeoMark Web Service REST API API

Explore with Jentic

View OpenAPI Document

The BC GeoMark Web Service creates and shares small geographic areas of interest as reusable, immutable web resources that can be retrieved in many file formats and coordinate systems. Once a geomark is created with POST /geomarks/new, the same geometry is exposed at /geomarks/{geomarkId} and supporting endpoints in formats such as GeoJSON, KML, and shapefile. This makes it easy to share an area of interest with people who use different mapping software without translating files manually. The service is read-mostly after creation, anonymous, and returns the bounding box, full feature, parts, and a representative point for each geomark.

Use Cases

Patterns agents use GeoMark Web Service REST API API for, with concrete tasks.

★ Cross-Agency Area of Interest Sharing

BC government and partner agencies share a project boundary by uploading geometry to GeoMark and circulating the resulting URL instead of emailing shapefiles. POST /geomarks/new accepts the geometry and assigns a stable geomarkId, and downstream tools fetch the area in their preferred format from /geomarks/{geomarkId}.{fileFormatExtension}. Eliminates format-conversion friction.

Create a geomark from a sample polygon and return the geomark URL plus the GeoJSON download URL.

Map Framing with Bounding Boxes

Render a map zoomed to a geomark's extent without downloading the full geometry. GET /geomarks/{geomarkId}/boundingBox.{fileFormatExtension} returns just the rectangle that bounds the geomark, which is fast and lightweight for map initialisation. Pair with /geomarks/{geomarkId}/point for a label position.

For an existing geomark ID, retrieve the bounding box as JSON and return its minimum and maximum latitude and longitude.

Format-Free Distribution to Field Tools

Field crews running different mapping software each request the geomark in their preferred file format from the same shareable URL. The {fileFormatExtension} path parameter selects KML for Google Earth, shapefile for desktop GIS, or GeoJSON for web mapping. This removes the need to ship multiple file copies for a single area of interest.

Retrieve an existing geomark in GeoJSON and return a summary of its feature type and the number of parts.

AI Agent Boundary Manager

An AI ops agent built on Jentic accepts a polygon from a user, registers a geomark, and returns shareable URLs in GeoJSON, KML, and shapefile in a single response. The agent searches Jentic for 'create a geomark' and loads the POST /geomarks/new operation, so the entire flow happens without the user touching geomark concepts directly.

Use Jentic to search 'create a geomark' and submit a sample polygon, then return the JSON, KML, and shapefile URLs of the resulting geomark.

Key Endpoints

7 endpoints — the bc geomark web service creates and shares small geographic areas of interest as reusable, immutable web resources that can be retrieved in many file formats and coordinate systems.

METHOD

PATH

DESCRIPTION

POST

/geomarks/new

Create a new geomark from supplied geometry

POST

/geomarks/copy

Create a geomark by copying existing geomarks

GET

/geomarks/{geomarkId}.{fileFormatExtension}

Retrieve a geomark in the requested file format

GET

/geomarks/{geomarkId}/boundingBox.{fileFormatExtension}

Retrieve only the geomark's bounding box

GET

/geomarks/{geomarkId}/feature.{fileFormatExtension}

Retrieve the full feature geometry

GET

/geomarks/{geomarkId}/parts.{fileFormatExtension}

Retrieve the parts of a multi-part geomark

GET

/geomarks/{geomarkId}/point.{fileFormatExtension}

Retrieve a representative point for the geomark

POST

/geomarks/new

Create a new geomark from supplied geometry

POST

/geomarks/copy

Create a geomark by copying existing geomarks

GET

/geomarks/{geomarkId}.{fileFormatExtension}

Retrieve a geomark in the requested file format

GET

/geomarks/{geomarkId}/boundingBox.{fileFormatExtension}

Retrieve only the geomark's bounding box

GET

/geomarks/{geomarkId}/feature.{fileFormatExtension}

Retrieve the full feature geometry

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

No credentials are required. Jentic still routes calls through its policy layer so audit logs of geomark creation are preserved even though no secret is injected.

Intent-based discovery

Agents search by intent (e.g., 'create a geomark' or 'fetch a geomark in geojson') and Jentic returns the right operation with its file format extension parameter typed.

Time to first call

Direct integration: a few hours to model the path-level format extension and retry logic. Through Jentic: under 30 minutes from sign-up to a working geomark create and fetch.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

BC Geocoder REST API

Use BC Geocoder to find addresses or sites inside a geomark's polygon

Pair when a geomark polygon needs to be enriched with the BC sites or occupants located inside it

Complementary

BC Geographical Names Web Service

Use bcgnws to list named features inside a geomark's bounding box

Pair when a geomark needs to be enriched with the official BC place names it contains

Alternative

TomTom Maps API

TomTom Maps offers global mapping data and tile services rather than BC-specific area sharing

Choose TomTom when the use case is global map rendering rather than BC-specific area-of-interest sharing

FAQs

Specific to using GeoMark Web Service REST API API through Jentic.

What authentication does the BC GeoMark Web Service use?

The OpenAPI spec defines no security schemes for this service, so requests are made anonymously over HTTPS. No API key or bearer token is required, and Jentic relays calls as-is without injecting credentials.

Can I retrieve a geomark in multiple file formats with the BC GeoMark API?

Yes. Each retrieval endpoint accepts a path-level fileFormatExtension such as .json, .geojson, .kml, or .shp. For example, GET /geomarks/{geomarkId}.kml returns the same area in KML for Google Earth and GET /geomarks/{geomarkId}.geojson returns it in GeoJSON for web mapping.

What are the rate limits for the BC GeoMark Web Service?

The OpenAPI spec does not declare specific rate limits. Because the service is shared public infrastructure, avoid creating geomarks in a tight loop and cache fetched representations on the client when serving them to many users.

How do I create a geomark through Jentic?

Search Jentic for 'create a geomark', load the POST /geomarks/new operation, and execute with the geometry and source coordinate system. With pip install jentic, the call returns the geomark ID and shareable URLs without requiring credentials.

Can I copy an existing geomark to make a derived area of interest?

Yes. POST /geomarks/copy creates a new geomark from one or more existing geomark IDs. This is useful when the original geomark needs small edits or when several geomarks need to be combined into a single shareable area.