Skip to content
Help

Introducing the Query API

Introduction

Section titled “Introduction”

The Koordinates APIs allow users to query data hosted on Koordinates via simple HTTP requests. They are accessible to any user who has a valid login to Koordinates.

Authentication

Section titled “Authentication”

You need an API key with the query scope to access the hosted data. Pass it with each request either as the key GET parameter (?key=YOUR_API_KEY) or in an Authorization: key YOUR_API_KEY request header. A missing or invalid key returns a 403 invalid-api-key error. Use a header where you can, as URLs are often logged.

It’s a good idea to use separate keys for each application you build. To create an API key, select API Keys in your user menu. This opens the API Keys page.

Available APIs:

Section titled “Available APIs:”
  • Vector Query - look up a point location and get information from one or more vector layers about nearby features.
  • Raster Query - look up a point location and get back information from raster/grid data about the values in each image band.
  • Set Query - look up data for multiple layers in a set.
  • Feature Query (/services/query/v1/feature.json/LAYER_ID/) - get attribute data from a single layer or table, with filtering and sorting.