geocoding-skill

Geocoding Tool

Convert addresses to GPS coordinates or coordinates to addresses using Google Maps Geocoding API.

How It Works

This skill provides instructions for the Add Locations (gmaps_locations) tool node. Connect the Add Locations node to Zeenie's input-tools handle to enable geocoding operations.

add_locations Tool

Geocode addresses or reverse geocode coordinates.

Schema Fields

Field	Type	Required	Description
service_type	string	Yes	"geocode" (address to coordinates) or "reverse_geocode" (coordinates to address)
address	string	If geocode	Address to convert to coordinates
lat	float	If reverse_geocode	Latitude coordinate
lng	float	If reverse_geocode	Longitude coordinate

Operations

Service Type	Input	Output
geocode	Address string	Coordinates (lat, lng)
reverse_geocode	Coordinates (lat, lng)	Formatted address

Examples

Geocode an address:

{
  "service_type": "geocode",
  "address": "1600 Amphitheatre Parkway, Mountain View, CA"
}

Geocode a landmark:

{
  "service_type": "geocode",
  "address": "Eiffel Tower, Paris"
}

Geocode a city:

{
  "service_type": "geocode",
  "address": "New York City, USA"
}

Reverse geocode (coordinates to address):

{
  "service_type": "reverse_geocode",
  "lat": 48.8584,
  "lng": 2.2945
}

Response Format

Geocode response:

{
  "success": true,
  "service_type": "geocoding",
  "input": {"address": "Eiffel Tower, Paris"},
  "results": [
    {
      "formatted_address": "Champ de Mars, 5 Av. Anatole France, 75007 Paris, France",
      "geometry": {
        "location": {"lat": 48.8583701, "lng": 2.2944813}
      },
      "address_components": [
        {"long_name": "5", "short_name": "5", "types": ["street_number"]},
        {"long_name": "Avenue Anatole France", "short_name": "Av. Anatole France", "types": ["route"]},
        {"long_name": "Paris", "short_name": "Paris", "types": ["locality"]}
      ]
    }
  ],
  "status": "OK"
}