---
title: "Introduction"
description: "Maps, search and routing APIs built on up-to-date data for Ethiopia and Africa."
canonical_url: "http://0.0.0.0:6006/"
markdown_url: "http://0.0.0.0:6006/.md"
last_updated: "2026-11-13"
x_farming_labs_generated_preamble: true
---

# Introduction
URL: /
LLM index: /llms.txt
Description: Maps, search and routing APIs built on up-to-date data for Ethiopia and Africa.

# Introduction

Gebeta Maps gives you the building blocks for location features: find places, turn coordinates into addresses, plan routes for one vehicle or a whole fleet, and show it all on a map. Every API is a plain HTTPS request that returns JSON.

## Get an API key

Every request needs an API key. [Sign in to the dashboard](https://gebeta.app/#/auth/sign-in) to create one and manage your keys, then pass it as the `apiKey` query parameter.

```bash
curl "https://mapapi.gebeta.app/v2/search/geocode?query=Bole+Road&apiKey={your-api-key}"
```

<Callout title="Keep your key private">
  Anyone with your key can make requests on your account. Don't commit it to a public repository or
  ship it in client code you don't control.
</Callout>

## APIs

<Cards>
  <Card
    title="Geocoding"
    description="Turn place names into coordinates, and coordinates into addresses."
    href="/geocoding"
  />
  <Card
    title="Directions"
    description="Routes between two points, with travel time, distance and alternatives."
    href="/direction"
  />
  <Card
    title="Matrix"
    description="Durations and distances between every pair of points."
    href="/matrix"
  />
  <Card
    title="Route Optimization"
    description="The best order to visit a set of stops."
    href="/route-optimization"
  />
  <Card
    title="Vehicle Routing"
    description="Split deliveries across a fleet, within each vehicle's capacity."
    href="/vrp"
  />
  <Card
    title="Map Matching"
    description="Snap noisy GPS traces to the road network."
    href="/map-matching"
  />
  <Card
    title="ONM"
    description="Travel time from one origin to several destinations, to find the closest."
    href="/onm"
  />
  <Card
    title="Place Validation"
    description="Check each level of an address, with a confidence score."
    href="/place-validation"
  />
  <Card
    title="Tracking"
    description="Stream live vehicle locations over WebSockets."
    href="/tracking"
  />
</Cards>

## Try it first

The [API playground](/api-playground) lets you send real requests from the browser, and the [Map playground](/map-playground) shows routes and places on a live map.

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).