Skip to main content

cURL Examples

Command-line examples for all geocodeme.net API endpoints.

Set your API key in an environment variable first:

export GEOCODEME_API_KEY="gm_YOUR_KEY"

Forward Geocoding​

# Geocode an address
curl -H "X-Api-Key: $GEOCODEME_API_KEY" \
  "https://api.geocodeme.net/v1/geocode?q=1+rue+de+Rivoli+Paris&limit=1"

# Restrict results to one of the covered countries (here France; try de, es, it…)
curl -H "X-Api-Key: $GEOCODEME_API_KEY" \
  "https://api.geocodeme.net/v1/geocode?q=Rennes&countrycodes=fr"

# Get GeoJSON format
curl -H "X-Api-Key: $GEOCODEME_API_KEY" \
  "https://api.geocodeme.net/v1/geocode?q=Lyon&format=geojson"

Reverse Geocoding​

# Reverse geocode coordinates
curl -H "X-Api-Key: $GEOCODEME_API_KEY" \
  "https://api.geocodeme.net/v1/reverse?lat=48.8566&lon=2.3522"

# Lower zoom for city-level result
curl -H "X-Api-Key: $GEOCODEME_API_KEY" \
  "https://api.geocodeme.net/v1/reverse?lat=48.8566&lon=2.3522&zoom=10"

Map Matching​

# Snap a GPS trace to roads (Champs-Élysées area)
curl -X POST \
  -H "X-Api-Key: $GEOCODEME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "coordinates": [
      [2.2950, 48.8738],
      [2.3010, 48.8720],
      [2.3080, 48.8700]
    ],
    "profile": "car",
    "geometries": "geojson"
  }' \
  "https://api.geocodeme.net/v1/match"

Snap to Road​

# Find nearest road to a point (Gare de Lyon)
curl -H "X-Api-Key: $GEOCODEME_API_KEY" \
  "https://api.geocodeme.net/v1/nearest?lat=48.8443&lon=2.3735"