> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hudhud.sa/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> API documentation for the Hudhud Maps KSA road network and addressing services.

## Saudi-First Mapping Infrastructure

Hudhud Maps provides vector maps, geocoding, and routing services specifically optimized for the Kingdom of Saudi Arabia. Our APIs integrate directly with the Saudi National Address system and provide native RTL (Right-to-Left) support for all map labels.

<CardGroup cols={2}>
  <Card title="Vector Map Styles" icon="map" href="/guides/displaying-a-map">
    MapLibre-compliant styles optimized for Saudi road networks and bilingual labels.
  </Card>

  <Card title="Geocoding Search" icon="magnifying-glass" href="/api-reference/geocoding/geocode-search">
    Search for places and addresses across the Kingdom.
  </Card>

  <Card title="Shortcode Lookup" icon="hashtag" href="/api-reference/geocoding/shortcode-lookup">
    Direct resolution of Saudi National Address shortcodes to coordinates.
  </Card>

  <Card title="Distance Matrix" icon="table-cells" href="/api-reference/routing/distance-matrix">
    Calculate travel times and distances across the road network.
  </Card>
</CardGroup>

## Getting Access

Access to the Hudhud APIs requires a Publishable and Secret API key.

<CardGroup cols={2}>
  <Card title="Request API Keys" icon="key" href="mailto:hello@hudhud.sa">
    Contact our team to get credentials for your development environment.
  </Card>

  <Card title="Authentication Guide" icon="shield-check" href="/guides/authentication">
    Learn about our Secret and Publishable key architecture.
  </Card>
</CardGroup>