zip-code-to-lat-and-long

Convert US zip codes to latitude/longitude coordinates using free APIs. No API key required. Covers Zippopotam.us (simplest) and OpenStreetMap Nominatim (alternative) with curl examples.

Jump to install

Repository: adamrdrew/claude-code-patterns
Last source activity: February 4, 2026 at 11:42
Detected SKILL.md language: English
Stars: 1
Forks: 0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/adamrdrew/claude-code-patterns --skill zip-code-to-lat-and-long

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

notes-add

Add a new note or update an existing one. Creates the notes database if it doesn't exist.

2026-02-04

notes-delete

Delete a note from the database. Removes the note file and its index entry.

2026-02-04

notes-list

List all notes in the database with their topics and descriptions.

2026-02-04

View all from this repository

# Get latitude
curl -s "https://api.zippopotam.us/us/10001" | jq -r '.places[0].latitude'

# Get longitude
curl -s "https://api.zippopotam.us/us/10001" | jq -r '.places[0].longitude'

# Get both as comma-separated
curl -s "https://api.zippopotam.us/us/10001" | jq -r '.places[0] | "\(.latitude),\(.longitude)"'

Field	Description
`post code`	The zip code queried
`country`	Full country name
`country abbreviation`	2-letter country code (US)
`places`	Array of locations (usually 1 for zip codes)
`places[].place name`	City/town name
`places[].state`	Full state name
`places[].state abbreviation`	2-letter state code
`places[].latitude`	Latitude as string
`places[].longitude`	Longitude as string

https://nominatim.openstreetmap.org

GET /search?postalcode={zip}&country=USA&format=json

curl -H "User-Agent: MyApp/1.0 (contact@example.com)" \
  "https://nominatim.openstreetmap.org/search?postalcode=90210&country=USA&format=json"

[
  {
    "place_id": 123456,
    "licence": "Data © OpenStreetMap contributors, ODbL 1.0.",
    "lat": "34.0901",
    "lon": "-118.4065",
    "display_name": "90210, Beverly Hills, Los Angeles County, California, United States",
    "type": "postcode",
    "importance": 0.435
  }
]

curl -s -H "User-Agent: MyApp/1.0" \
  "https://nominatim.openstreetmap.org/search?postalcode=10001&country=USA&format=json" \
  | jq -r '.[0] | "\(.lat),\(.lon)"'

Feature	Zippopotam.us	Nominatim
API Key	Not required	Not required
User-Agent	Not required	Required
Rate Limit	None documented	1 req/sec
US Coverage	43,624 zip codes	Comprehensive
Response	Simple JSON	Detailed JSON
Best For	Simple zip lookups	General geocoding

Requirement	Details
User-Agent	Required - Must identify your application
Rate Limit	Max 1 request per second
No Bulk Queries	Cannot download complete lists of postcodes

zip-code-to-lat-and-long

Install options

Review the source files

Zip Code to Latitude/Longitude APIs

Option 1: Zippopotam.us (Recommended)

Base URL

Endpoint Format

Example CURL

Response Format

Zip Code to Latitude/Longitude APIs

Option 1: Zippopotam.us (Recommended)

Base URL

Endpoint Format

Example CURL

Response Format

Extracting Coordinates with jq

Response Fields

Notes

Option 2: OpenStreetMap Nominatim

Base URL

Endpoint Format

Example CURL

Response Format

Extracting Coordinates with jq

Important Requirements

When to Use Nominatim

Comparison

Recommendation

name	zip-code-to-lat-and-long
description	Convert US zip codes to latitude/longitude coordinates using free APIs. No API key required. Covers Zippopotam.us (simplest) and OpenStreetMap Nominatim (alternative) with curl examples.

zip-code-to-lat-and-long

Source facts

Install options

Review the source files

More from this repository

More from this repository

Zip Code to Latitude/Longitude APIs

Option 1: Zippopotam.us (Recommended)

Base URL

Endpoint Format

Example CURL

Response Format

Zip Code to Latitude/Longitude APIs

Option 1: Zippopotam.us (Recommended)

Base URL

Endpoint Format

Example CURL

Response Format

Extracting Coordinates with jq

Response Fields

Notes

Option 2: OpenStreetMap Nominatim

Base URL

Endpoint Format

Example CURL

Response Format

Extracting Coordinates with jq

Important Requirements

When to Use Nominatim

Comparison

Recommendation