Reverse Geocoding allows you to convert coordinates into Geo-Features with their Addresses, Names, Properties, and Shapes. If you would like to learn more about the information you can retrieve, take a look at the Geo-Feature Model.

Examples

Minimum

https://api.cartesius.io/beta/reverse?apiKey=<YOUR_API_KEY>&lat=52.517831262&
lon=13.372331844

import { CartesiusClient } from "@cartesius/sdk"

const client = new CartesiusClient({
  apiKey: '<YOUR-API-KEY>',
});

const result = await client.reverse(52.517831262, 13.372331844);

With Filters (Languages, Categories)

https://api.cartesius.io/beta/forward?apiKey=<YOUR_API_KEY>&languages=de,en,es&categories=amenity:restaurant,highway&bbox=9.65,53.38,10.33,53.75&q=Platz d. Deutschen Einheit 4, 20457 HH

import { CartesiusClient } from "@cartesius/sdk"

const client = new CartesiusClient({
  apiKey: '<YOUR-API-KEY>',
});

client.reverse(52.517831262, 13.372331844, 5, {
  languages: ['deu', 'en'], // ISO 3166 ALPHA-2 or ALPHA-3
  fields: ['w3w', 'displayValue'], // fields to return
  categories: {
    type: 'amenity',
  },
});

Results

The Results will contain Geo features in the given radius (defaults to 1 km) sorted ascending by the distance to the given coordinates.

The result will be a list of valid GeoJSON Features (RFC 7946). A detailed overview of all properties with explanations can be found here.

Endpoint Documentation