personal-map

Generate an AMap personal map mini-program QR code from geocoding, POI search, and route planning.

54|1|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/amap-demo/amap-sdk-skills --skill personal-map
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: personal-map
Source: https://github.com/amap-demo/amap-sdk-skills/tree/main/personal-map
Command: npx skills add https://github.com/amap-demo/amap-sdk-skills --skill personal-map

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) components.

What problem does it solve?

This Skill turns place finding, address/coordinate conversion, and route planning into a ready-to-share personal map experience by generating a personal map mini-program QR code for use in the AMap app.

Core Features & Use Cases

  • Geocoding & Reverse Geocoding: Convert an address to coordinates and convert coordinates back to structured address information.
  • POI Search (Text & Around): Find nearby restaurants, attractions, malls, and other points of interest, then collect their details.
  • Route Planning (Walking/Driving/Transit): Plan routes between two coordinate points and support itinerary building.
  • Personal Map QR Code Generation (Core): Create an AMap personal map mini-program schema and generate a QR code link/image for sharing.

Quick Start

Ask the AI to generate a personal AMap map for your plan by providing the place(s) or origin/destination, then ensure it finishes by calling maps_schema_personal_map to produce your QR code.

Frequently Asked Questions about personal-map

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a shareable AMap itinerary QR code for route planning?

To generate a shareable AMap itinerary QR code, provide your origin, destination, or points of interest to compose route planning and POI search outputs into a personal map mini-program schema. The schema is then converted into a QR code link for instant sharing.

Can I convert addresses to coordinates and find nearby POIs for a custom map?

Yes, you can convert addresses to coordinates via geocoding and find nearby POIs using text and around search APIs. These location details are collected and combined to build the personalized AMap mini-program for sharing.

Do I need an AMAP API key to create a personal map mini-program?

Yes, a valid AMAP API key is required to create a personal map mini-program. The Skill uses this key to authenticate requests to AMap REST endpoints for geocoding, POI search, and route planning before generating the final QR code.

What's the best way to share a travel itinerary map using AMap Web services?

The best way to share a travel itinerary using AMap Web services is to aggregate geocoding, POI search, and route planning results into a personal map schema. This schema generates a QR code that users can scan to open the itinerary in the AMap app.

Does AMap route planning support walking, driving, and transit for itinerary building?

AMap route planning supports walking, driving, and transit directions between two coordinate points. These route outputs are used to build itineraries that are then visualized and shared through the personal map mini-program QR code.

Why is my personal map QR code not generating correctly?

Your personal map QR code may fail if the final schema is not generated via maps_schema_personal_map with a correct sceneType. Ensure your AMAP API key is valid and that all geocoding, POI search, or route planning outputs are correctly composed.