free-geocoding-and-maps

Geocode addresses and reverse geocode coordinates via OpenStreetMap Nominatim.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/cogidoo/sunchaser --skill free-geocoding-and-maps-cogidoo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: free-geocoding-and-maps
Source: https://github.com/cogidoo/sunchaser/tree/main/.agents/skills/free-geocoding-and-maps
Command: npx skills add https://github.com/cogidoo/sunchaser --skill free-geocoding-and-maps-cogidoo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables geocoding addresses and reverse geocoding coordinates using the free OpenStreetMap Nominatim API, offering a privacy-respecting alternative to paid geocoding services.

Core Features & Use Cases

  • Geocode addresses to coordinates using Nominatim for location search and mapping.
  • Reverse geocode coordinates to human-readable addresses for validation and display.
  • Support nearby-place searches and distance calculations to build location-aware features.
  • Learn and reuse production-grade patterns for rate limiting, error handling, and structured queries.

Quick Start

Geocode an address like '1600 Amphitheatre Parkway, Mountain View, CA' using the Nominatim API to retrieve coordinates.

Frequently Asked Questions about free-geocoding-and-maps

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

FAQPage Schema
How do I geocode addresses to coordinates using a free API without an API key?

OpenStreetMap Nominatim provides free geocoding without requiring an API key. You can convert addresses to coordinates by sending structured queries to the public API, which supports location search and mapping while respecting privacy-friendly usage limits.

Can I perform reverse geocoding to get a human-readable address from coordinates?

Reverse geocoding converts coordinates into human-readable addresses using OpenStreetMap Nominatim. This capability supports address validation and display by querying the API with latitude and longitude values to retrieve structured location data.

What are the rate limits and requirements for using the public Nominatim API?

The public Nominatim API enforces a strict 1 request per second rate limit and requires a User-Agent header. Implementing caching to minimize calls and robust error handling with timeout management is essential for production-grade usage.

Does OpenStreetMap Nominatim support structured address queries for location search?

OpenStreetMap Nominatim supports structured address queries for precise location search. This allows you to pass individual address components like street, city, and country separately to accurately geocode addresses into coordinates.

Why should I choose OpenStreetMap Nominatim over paid geocoding services?

OpenStreetMap Nominatim offers a privacy-respecting, free alternative to paid geocoding services with a no-key policy. It is ideal for location search and address validation within its usage limits, ensuring data privacy without subscription costs.