Skip to content

Area Service

The Area Service provides a REST API for querying geographic boundaries and areas based on geographic coordinates or OpenStreetMap (OSM) IDs. This API supports both JSON and GeoJSON formats, ensuring seamless integration with a wide range of applications.

Key Features

Administrative Levels

The API utilizes OpenStreetMap's admin_level values to deliver detailed insights into various administrative boundaries. These levels range from national borders (level 2) to electoral wards and school districts (level 11), with the flexibility to accommodate additional levels depending on regional specifications. This hierarchical structure allows for precise and context-specific boundary queries.

Endpoints

The Area Service API offers multiple endpoints to address diverse geographic data needs:

  • Get Boundaries at a Point: Retrieve boundaries and areas at a specific geographic point via a simple POST or GET request. Customize your query with parameters such as apiKey, level, latitude, and longitude.

  • Get Boundaries in a Rectangle: Define a rectangular extent to obtain boundaries and areas within that region. This endpoint is ideal for analyzing larger geographic areas.

  • Get Boundaries for an OSM ID: Access boundaries and areas associated with a specific OpenStreetMap ID, providing a direct link to OSM's extensive geographic data.

Flexible Query Parameters

Our API supports a wide range of query parameters, including:

  • Geographic Filters: Use isoCountries and isoLanguages to filter results by country and language.
  • Geometry Precision: Adjust the reduceGeometry factor and zoom level to control the detail and accuracy of the returned geometries.

GeoJSON FeatureCollections

All API responses are delivered as GeoJSON FeatureCollections, providing a standardized and easily interpretable format. Each response includes:

  • Type: The type of the GeoJSON object ("FeatureCollection").
  • Bounding Box: The bounding box of the boundaries.
  • Features: An array of individual boundaries and areas, complete with geometry and additional properties such as names, ISO codes, and postal codes.

Leverage the Area Service API to unlock the potential of geographic data in your applications. Whether you are developing location-based services, conducting spatial analysis, or integrating with mapping platforms, our API provides the tools you need for accurate and efficient boundary queries.