fullTextAddressGeocoding
Convert any address into precise geographical coordinates, including latitude, longitude, and entrance points, using geocoding functionality.
Instructions
Converts the given address to coordinates (geocoding).
Args address (str): address to convert.
Returns: a list of coordinates
newLat: latitude
newLon: longitude
newLatEntr: latitude of the entrance
newLonEntr: longitude of the entrance
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes |
Implementation Reference
- src/mcp_tmap/server.py:75-95 (handler)MCP tool handler for 'fullTextAddressGeocoding' that validates input and delegates to TmapClient.fullAddressGeocoding
@mcp.tool() async def fullTextAddressGeocoding(address: str) -> List | Dict: """Converts the given address to coordinates (geocoding). Args address (str): address to convert. Returns: a list of coordinates - newLat: latitude - newLon: longitude - newLatEntr: latitude of the entrance - newLonEntr: longitude of the entrance """ assert len(address.strip()) > 0 try: return await tmap_client.fullAddressGeocoding(address) except Exception as ex: return { "success": False, "error": str(ex) } - src/mcp_tmap/tmap_client.py:46-61 (helper)TmapClient method implementing the geocoding logic via HTTP GET to SK TMAP API endpoint
async def fullAddressGeocoding( self, fullAddress: str, count: int = 10, ) -> List: path = f"{self.BASE_URL}/tmap/geo/fullAddrGeo" params = { "version": 1, "addressFlag": "F02", # accepts both street address and lot number address (지번) "fullAddr": fullAddress, "count": count, "format": "json", } return (await self._get(path, params)).get("coordinateInfo", {}).get("coordinate", []) - src/mcp_tmap/server.py:77-88 (schema)Docstring schema describing input (address: str) and output format (list of coordinates with lat/lon)
"""Converts the given address to coordinates (geocoding). Args address (str): address to convert. Returns: a list of coordinates - newLat: latitude - newLon: longitude - newLatEntr: latitude of the entrance - newLonEntr: longitude of the entrance """