jisu-geoconvert

What This Skill Does

The jisu-geoconvert skill is a robust geospatial integration for OpenClaw that leverages the JisuData API to bridge the gap between coordinates and physical addresses. It provides a seamless interface for two primary operations: converting geographical coordinates (latitude and longitude) into human-readable address strings, and reverse-geocoding specific addresses to retrieve their precise coordinate points. By supporting both Baidu and Google map coordinate systems, this skill ensures accuracy across different geographical service environments, making it an essential tool for location-aware AI agents.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/jisuapi/geoconvert

Post-installation, you must authenticate the skill by setting your JisuData API key. For Linux/macOS users, run export JISU_API_KEY="your_appkey_here". For Windows users, set the environment variable via PowerShell: $env:JISU_API_KEY="your_appkey_here". Ensure that your account on the official JisuData platform is active and has sufficient request quotas.

Use Cases

• Logistics & Delivery: Convert customer address inputs into exact coordinates for routing or delivery confirmation.
• Content Curation: Enrich location-based user posts by translating raw GPS metadata into specific regional or street-level addresses.
• Asset Tracking: Monitor location movement by continuously converting real-time coordinates into readable descriptions.
• GIS Data Analysis: Standardize location datasets by ensuring both latitude/longitude and address fields are populated and synchronized.

Example Prompts

1. "Look up the physical address for these coordinates: lat 30.2812129803, lng 120.11523398 using Baidu maps."
2. "I need to find the longitude and latitude for '益乐路39号'. Please provide the coordinates using the Google map system."
3. "Where is the location defined by 30.281, 120.115? Tell me the city and district it belongs to."

Tips & Limitations

• Type Accuracy: Always specify the coordinate system (baidu or google) to avoid offset errors caused by different datum standards. Default is baidu.
• API Quotas: Monitor your usage via the JisuData dashboard. Repeated requests beyond your plan's limit will return error code 104.
• Environment Variables: The skill relies strictly on the JISU_API_KEY environment variable; ensure it is correctly defined in the shell environment where OpenClaw runs.
• Performance: This skill performs network requests, so allow for slight latency depending on your network conditions. If you receive code 203, double-check your coordinate formatting for invalid entries.