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

# AMAP

> Configure AMAP capabilities to add interactive maps, geocoding, and place search to your app.

## What It Is

AMAP is a map and location service plugin powered by the AMAP (高德地图) platform. It adds interactive maps, geocoding, reverse geocoding, place search, and route planning to apps you build.

The plugin is enabled per project. You can start with platform test keys or switch to your own AMAP application keys for production use.

***

## Where to Find It

1. Open any project.
2. Switch to the **Build** tab.
3. Open **Skill Library** from the left navigation.
4. Find **AMAP** in the plugin cards.

***

## Enable

Any of the following enables it:

* Hover the plugin card and click **Use**.
* Open the plugin detail page and click **Use** in the header.
* Confirm the plugin enablement card when the AI assistant suggests it in chat.

After enabling, configure your AMAP keys on the plugin detail page.

***

## Configure

Open the plugin detail page after enabling. You have two modes:

### Platform test keys

Leave all three key fields blank to use the built-in platform test keys. Quota is limited and it is not recommended for production.

### Your own AMAP application

Fill in all three keys from your AMAP console:

* **Web Service Key**: used for geocoding, reverse geocoding, place search, route planning, and similar service calls.
* **JS API Key**: used for the browser map SDK, map point picking, and interactive frontend map rendering.
* **Security Key**: used for securityJsCode in JS API 2.0 or when referer / security validation is enabled.

When using your own keys, all three fields must be filled in together. Click **Save configuration** to apply.

To switch back from your own keys to the platform test keys, use the **Restore platform default** action on the detail page.

***

## Disable

Open the plugin detail page, click **Disable** in the header, and confirm in the dialog.

***

## FAQ

<AccordionGroup>
  <Accordion title="Can I use my own AMAP keys alongside the platform test keys?">
    No. You either use the platform test keys (all three blank) or provide your own full three-key set. Partial custom keys are not supported.
  </Accordion>

  <Accordion title="Which AMAP services does this plugin cover?">
    The plugin covers Web Service APIs (geocoding, place search, route planning) and JS API (browser maps, point picking). Other AMAP services may require additional configuration.
  </Accordion>
</AccordionGroup>