Skip to content

The Data Appeal Company: Territorial API

Welcome to the Territorial API documentation, a developer guide designed to help efficiently use Territorial API.

Territorial API provides valuable insights about any area in the world.
An Area can be identified using three different methods described below:

MethodExample on map
AdministrativeAreaAdministrative Area
The following administrative divisions' hierarchy can be used to determine an area:
  • country (e.g. Italy)
    • state (e.g. Toscana)
      • county (e.g. Firenze)
        • city (e.g. Firenze)
          • suburb (e.g. San Frediano)
GeometryID
A saved geometry, enclosing an area within a single or multiple polygons, can be used to determine an area by its geometry_id.
The polygons of a saved geometry are expressed in standard format WKT and can be retrieved with Retrieve Geometry:
POLYGON((
10.614595 43.833381, 
10.96118  43.850282,
11.172152 44.178572, 
11.455479 43.889604,
11.952009 43.904757, 
11.491356 43.622749,
11.815152 43.347745, 
11.222191 43.505484,
10.84784  43.311439, 
10.948434 43.641572,
10.614595 43.833381))
Circle
An area can be determined by the enclosing perimeter of a circle, specifying its center coordinates and radius:
- Center:
  - Latitude: 43.770366014832014
  - Longitude: 11.257818620617464

- Radius (in kilometers): 40

Data for an area is determined by the aggregation of POIs within it.

Data Appeal uses REST-based API, which has predictable, resource-oriented URLs and uses HTTP response codes to indicate API errors.

Built-in HTTP features, such as HTTP authentication and HTTP methods, ensure compliance with off-the-shelf HTTP clients.

JSON is returned by all API responses, allowing conversion to appropriate language-specific objects.

All API requests must be performed via HTTPS. Calls made over plain HTTP will be redirected to HTTPS protocol. API requests without authentication will fail.

This document will outline requests, responses, usage limits and the API Set in detail.