{"_id":"@amap-lbs/amap-gui","_rev":"4-998a950b69475e63e27af40e14660335","name":"@amap-lbs/amap-gui","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.0":{"name":"@amap-lbs/amap-gui","version":"1.0.0","keywords":["amap","gaode","map","electron","cli","ai-agent","visualization"],"author":{"name":"amap"},"license":"MIT","_id":"@amap-lbs/amap-gui@1.0.0","maintainers":[{"name":"amap-lbs-op","email":"amap-lbs-op@service.alibaba.com"}],"bin":{"amap-gui":"dist/cli/index.js"},"dist":{"shasum":"f02f902452075cfd54885ea0171daf5e2acaea23","tarball":"https://registry.npmjs.org/@amap-lbs/amap-gui/-/amap-gui-1.0.0.tgz","fileCount":15,"integrity":"sha512-37XXnh3Vu/E1MnlQCpEqiKbvAhR+xM0fhNlRNTsGKKB2nCu7wCaBu7Xlm+qm3a+c2JVgxuTchGAdpEMWxhaYPw==","signatures":[{"sig":"MEUCIDCWUyAUlaUSxXjNUZpf8JEhXqAQHkG5vVTI1pExAiCvAiEA38jB5+z/iFpsz+JxLVwg5vOQPkqKtoqrBFkhhWtqheo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":181242},"main":"dist/main.js","engines":{"node":">=18.0.0"},"gitHead":"70e19fb796316ecbbe55a3387066a65b2f92a608","scripts":{"cli":"node cli/index.js","dev":"electron .","build":"node scripts/build.js","start":"AMAP_KEY=${AMAP_KEY} electron .","prepublishOnly":"npm run build"},"_npmUser":{"name":"amap-lbs-op","email":"amap-lbs-op@service.alibaba.com"},"_npmVersion":"10.9.2","description":"AI-driven AMap (Gaode) visualization CLI — drives an Electron map container with route planning, POI search and map-state control","directories":{},"_nodeVersion":"23.5.0","dependencies":{"electron":"^28.0.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"javascript-obfuscator":"^4.2.2"},"_npmOperationalInternal":{"tmp":"tmp/amap-gui_1.0.0_1774581219282_0.5776155722036707","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@amap-lbs/amap-gui","version":"1.0.1","keywords":["amap","gaode","map","electron","cli","ai-agent","visualization"],"author":{"name":"amap"},"license":"MIT","_id":"@amap-lbs/amap-gui@1.0.1","maintainers":[{"name":"amap-lbs-op","email":"amap-lbs-op@service.alibaba.com"}],"bin":{"amap-gui":"dist/cli/index.js"},"dist":{"shasum":"0ed1d3408907e09addac73fe27c6c4dc11cfc44c","tarball":"https://registry.npmjs.org/@amap-lbs/amap-gui/-/amap-gui-1.0.1.tgz","fileCount":15,"integrity":"sha512-VkgHzgaenVqc7oh5zsnN/g6tWGdDuAiPsTxAYuCh+DlZZ5zvWKsSXtivEtdBbuth+F3DyRoTAOp0T+Z5dXSwHQ==","signatures":[{"sig":"MEQCICD4788kVWmg9KnmGgoBshSrf65eJ+B++yLMbTl226U4AiBtkmykdg6GEihMQG/KVWNjZAleiY7odOGLFZpVTC1V5w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":184630},"main":"dist/main.js","engines":{"node":">=18.0.0"},"gitHead":"70e19fb796316ecbbe55a3387066a65b2f92a608","scripts":{"cli":"node cli/index.js","dev":"electron .","build":"node scripts/build.js","start":"AMAP_KEY=${AMAP_KEY} electron .","prepublishOnly":"npm run build"},"_npmUser":{"name":"amap-lbs-op","email":"amap-lbs-op@service.alibaba.com"},"_npmVersion":"10.9.2","description":"AI-driven AMap (Gaode) visualization CLI — drives an Electron map container with route planning, POI search and map-state control","directories":{},"_nodeVersion":"23.5.0","dependencies":{"electron":"^28.0.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"javascript-obfuscator":"^4.2.2"},"_npmOperationalInternal":{"tmp":"tmp/amap-gui_1.0.1_1774582107968_0.06918850316336256","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@amap-lbs/amap-gui","version":"1.0.2","keywords":["amap","gaode","map","electron","cli","ai-agent","visualization"],"author":{"name":"amap"},"license":"MIT","_id":"@amap-lbs/amap-gui@1.0.2","maintainers":[{"name":"amap-lbs-op","email":"amap-lbs-op@service.alibaba.com"}],"bin":{"amap-gui":"dist/cli/index.js"},"dist":{"shasum":"bb1cf2a77a58fe694e6ea9f5648a64553217616a","tarball":"https://registry.npmjs.org/@amap-lbs/amap-gui/-/amap-gui-1.0.2.tgz","fileCount":15,"integrity":"sha512-NI29zA/cnO9s7Bs872kaY1zBKTdhWr4GLbMlfaNu49IRcBQienkd1ngnVaQ3iEmS+DVdWkJzyDygQFPJA8a2dg==","signatures":[{"sig":"MEYCIQDPTADLRVCMm7bY2WXlzA7ivMC0/cMeeddj2+00ajPI3QIhAOJljRTzpOJmf49EuIQJEb7zhVkAyWtK5vK9eRWt81re","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":229299},"main":"dist/main.js","engines":{"node":">=18.0.0"},"gitHead":"98b795828985943d85e8d8f9571e0014536013e1","scripts":{"cli":"node cli/index.js","dev":"electron .","build":"node scripts/build.js","start":"AMAP_KEY=${AMAP_KEY} electron .","prepublishOnly":"npm run build"},"_npmUser":{"name":"amap-lbs-op","email":"amap-lbs-op@service.alibaba.com"},"_npmVersion":"10.9.2","description":"AI-driven AMap (Gaode) visualization CLI — drives an Electron map container with route planning, POI search and map-state control","directories":{},"_nodeVersion":"23.5.0","dependencies":{"electron":"^28.0.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"javascript-obfuscator":"^4.2.2"},"_npmOperationalInternal":{"tmp":"tmp/amap-gui_1.0.2_1774936212736_0.8189520257148608","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@amap-lbs/amap-gui","version":"1.0.3","description":"AI-driven AMap (Gaode) visualization CLI — drives an Electron map container with route planning, POI search and map-state control","keywords":["amap","gaode","map","electron","cli","ai-agent","visualization"],"author":{"name":"amap"},"license":"MIT","main":"dist/main.js","bin":{"amap-gui":"dist/cli/index.js"},"scripts":{"start":"AMAP_KEY=${AMAP_KEY} electron .","dev":"electron .","build":"node scripts/build.js","prepublishOnly":"npm run build","cli":"node cli/index.js"},"engines":{"node":">=18.0.0"},"dependencies":{"electron":"^28.0.0"},"devDependencies":{"javascript-obfuscator":"^4.2.2"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_id":"@amap-lbs/amap-gui@1.0.3","gitHead":"7886ee7c671883ae6694cfaaa73aafc2ddfb5229","_nodeVersion":"23.5.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-TbeTzq7Mfd/3kDopvGeg3N1XFi3Cf/K0nzylGN25n4+Iev9eDe+AV6COH6WErRroDVrNKSHPJ6W41AhPdsjqJw==","shasum":"ca12315847969826ca8051109c7d6ee2858df22e","tarball":"https://registry.npmjs.org/@amap-lbs/amap-gui/-/amap-gui-1.0.3.tgz","fileCount":15,"unpackedSize":232312,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDt6N3vMS5vEdM6AglmyNL8qHLsdVM2McMLkRDkljo0YAIhALjSMhq67dPxKKLZch2FcfBP7tKfKBKuB66wPuDvGPAf"}]},"_npmUser":{"name":"amap-lbs-op","email":"amap-lbs-op@service.alibaba.com"},"directories":{},"maintainers":[{"name":"amap-lbs-op","email":"amap-lbs-op@service.alibaba.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/amap-gui_1.0.3_1775551898184_0.0644537195498398"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-27T03:13:39.192Z","modified":"2026-04-07T08:51:38.505Z","1.0.0":"2026-03-27T03:13:39.439Z","1.0.1":"2026-03-27T03:28:28.116Z","1.0.2":"2026-03-31T05:50:12.895Z","1.0.3":"2026-04-07T08:51:38.358Z"},"author":{"name":"amap"},"license":"MIT","keywords":["amap","gaode","map","electron","cli","ai-agent","visualization"],"description":"AI-driven AMap (Gaode) visualization CLI — drives an Electron map container with route planning, POI search and map-state control","maintainers":[{"name":"amap-lbs-op","email":"amap-lbs-op@service.alibaba.com"}],"readme":"# amap-gui\n\nAI-driven AMap (高德地图) visualization CLI — drives an Electron map container with route planning, POI search and map-state control. Designed for AI Agents.\n\n## Requirements\n\n- Node.js >= 18\n- A valid **AMap Web JS API Key** — apply at [lbs.amap.com](https://lbs.amap.com)\n\n## Installation\n\n```bash\nnpm install -g @amap-lbs/amap-gui\n```\n\n## Configure API Keys (Required)\n\nYou need **two keys** from the AMap open platform ([lbs.amap.com](https://lbs.amap.com)):\n\n| Env Var | Required | Description |\n|---------|----------|-------------|\n| `AMAP_KEY` | ✅ Yes | Web JS API Key |\n| `AMAP_SECURITY_KEY` | Recommended | JS API Security Key (required for some account types) |\n\n```bash\n# macOS / Linux — add to ~/.zshrc or ~/.bashrc for persistence\nexport AMAP_KEY=your_amap_web_js_key\nexport AMAP_SECURITY_KEY=your_amap_security_key\n\n# Windows (PowerShell)\n$env:AMAP_KEY=\"your_amap_web_js_key\"\n$env:AMAP_SECURITY_KEY=\"your_amap_security_key\"\n\n# Windows (cmd)\nset AMAP_KEY=your_amap_web_js_key\nset AMAP_SECURITY_KEY=your_amap_security_key\n```\n\n> The GUI will show an error and refuse to start the map if `AMAP_KEY` is missing.  \n> `AMAP_SECURITY_KEY` defaults to empty string if not set (safe for older API keys).\n\n## Usage\n\n```bash\n# 1. Check if the GUI container is running\namap-gui status\n\n# 2. Start the GUI (blocks until map is ready)\namap-gui start\n\n# 3. Control the map\namap-gui mapState --json '{\"action\":\"set\",\"center\":\"上海外滩\",\"zoom\":15,\"style\":\"dark\"}'\namap-gui route    --json '{\"from\":{\"position\":\"北京南站\"},\"to\":{\"position\":\"天安门\"},\"type\":\"driving\"}'\namap-gui searchPOI --json '{\"keyword\":\"咖啡\",\"city\":\"北京\"}'\n\n# 4. Stop the GUI\namap-gui stop\n```\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `amap-gui status` | Check container status (`not_running` / `running`) |\n| `amap-gui start` | Launch the Electron GUI (waits until `mapReady: true`) |\n| `amap-gui stop` | Shut down the container |\n| `amap-gui mapState --json '...'` | Get/set map view (center, zoom, pitch, style) |\n| `amap-gui route --json '...'` | Plan a route (driving / walking / riding / transit) |\n| `amap-gui searchPOI --json '...'` | Search POIs and pin them on the map |\n| `amap-gui getLastEvent` | Get last user interaction event on the map |\n\nAll commands return structured JSON: `{ success, data, error }`.\n\n## For AI Agents\n\nSee [SKILL.md](./SKILL.md) for detailed parameter schemas, response formats, and typical workflows.\n\n\n## Quick Start\n\n```bash\n# 1. Install\nnpm install -g @amap-lbs/amap-gui\n\n# 2. Configure API Key (one-time, add to ~/.zshrc for persistence)\nexport AMAP_KEY=your_amap_key\nexport AMAP_SECURITY_KEY=your_amap_security_key\n\n# 3. Start the GUI\namap-gui start\n\n# 4. Control the map\namap-gui mapState --json '{\"action\":\"set\",\"center\":\"北京\",\"zoom\":12}'\n\n# 5. Stop\namap-gui stop\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}