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 location in the world.
A location can be identified using three different methods described below:

MethodExample on map
Administrative AreaAdministrative Area
The following administrative divisions' hierarchy can be used to determine a location:
  • country (e.g. Italy)
    • state (e.g. Toscana)
      • county (e.g. Firenze)
        • city (e.g. Firenze)
          • suburb (e.g. San Frediano)
Geometry
Standard format WKT can be used to determine a location enclosed within a single or multiple polygons: 
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
A location can be determined by the enclosing area of a circle, specifying its center coordinates and radius: 
- Center:
  - Latitude: 43.770366014832014
  - Longitude: 11.257818620617464

- Radius (in meters): 40000

Data for a location is determined by the aggregation of POIs in the selected geographic area.

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.