Move from Google Maps Platform by changing one host
MapIron answers Google-style Geocoding API and Static Maps API requests. Change https://maps.googleapis.com to https://api.mapiron.com/v1/google and your Google key to a MapIron key: the paths, parameters and JSON shape stay the same.
No card · change one host, keep your request format
Geocoding
https://maps.googleapis.com/maps/api/geocode/json?address=233+S+Wacker+Dr,+Chicago,+IL&key=AIza…
https://api.mapiron.com/v1/google/maps/api/geocode/json?address=233+S+Wacker+Dr,+Chicago,+IL&key=YOUR_MAPIRON_KEY
The answer has Google's results and status, plus attribution and license. Show the attribution (© OpenStreetMap contributors) wherever you show the results. Reverse geocoding works the same way with latlng=41.8789,-87.6359.
Static maps
https://maps.googleapis.com/maps/api/staticmap?center=41.6843,-88.3512&zoom=14&size=600x400&scale=2&markers=color:red|41.6843,-88.3512&key=AIza…
https://api.mapiron.com/v1/google/maps/api/staticmap?center=41.6843,-88.3512&zoom=14&size=600x400&scale=2&markers=color:red|41.6843,-88.3512&key=YOUR_MAPIRON_KEY
Find every call in your code
The open-source mapiron-migrate (opens in a new tab) tool (MIT) lists every Google Geocoding and Static Maps URL in a folder and can rewrite the host for you. It reads files only on your machine and sends nothing anywhere.
npx -y github:Software-Consulting/mapiron-migrate ./src # list what would change
npx -y github:Software-Consulting/mapiron-migrate ./src --write # rewrite the host
It leaves your keys alone: put your MapIron key in an environment variable and pass it where the Google key went.
What carries over and what doesn't
| Google feature | Supported | Notes |
|---|---|---|
Geocoding: address= | Yes | Up to 5 results, Google's results/status shape |
Reverse geocoding: latlng= | Yes | |
formatted_address, address_components, geometry.location, viewport, types | Yes | location_type is ROOFTOP when a house number matched, GEOMETRIC_CENTER for streets, otherwise APPROXIMATE |
place_id | Different | An OpenStreetMap id such as osm:N123. Google place ids aren't accepted |
components, bounds, region, language | Ignored | Put the city or ZIP in the address instead |
| Errors | Yes | status is INVALID_REQUEST, REQUEST_DENIED, OVER_QUERY_LIMIT, ZERO_RESULTS or UNKNOWN_ERROR, with error_message; the HTTP status matches MapIron's other endpoints |
Static maps: center, zoom, size, scale, format | Yes | Sizes up to 1280×1280; scale=4 is drawn at 2 |
markers (repeatable), color: | Yes | Up to 25 pins in one colour (the first colour given); label:, size: and custom icons are ignored |
path with points or enc: polyline, color:, weight: | Yes | One path per image, up to 200 points (longer paths are thinned) |
Addresses in center or markers | No | Use latitude,longitude; geocode the address first |
maptype=satellite/hybrid, style=feature:… rules | No | Use style=dark, white or grayscale; satellite is available as tiles |
signature | Ignored | MapIron keys can be locked to your websites instead |
Before you switch
- Try your own addresses on the free plan first: OpenStreetMap and US public address records are strong in most places but not identical to Google.
- Re-geocode stored addresses with MapIron instead of copying Google results; Google's terms don't allow keeping them.
- Compare the costs in the bill calculator, or ask for a bill rescue if a bill is why you're here.
Questions
Does MapIron call Google behind the scenes?
No. The /v1/google endpoints only accept Google's request format. Every answer comes from MapIron's own OpenStreetMap-based data and public address records, and nothing is sent to Google.
Can I import the coordinates I already geocoded with Google?
Google's terms limit caching geocoded coordinates to 30 days and forbid using them on a non-Google map, so don't copy them into MapIron. Geocode the addresses again with MapIron; on paid plans you may keep those indefinitely.
Do the compatible endpoints cost more?
No. A geocoding request counts as one address lookup and a static map as one image, exactly like /v1/geocode and /v1/static.
Get a MapIron key
Free in under a minute, no card. New accounts get higher trial limits free for 14 days.
Sources
Read on Nov 19, 2026. Prices and terms change, so follow the links before deciding.
- Google Geocoding API: request and response (opens in a new tab)
- Google Maps Static API: developer guide (opens in a new tab)
- Google Maps Platform service specific terms (opens in a new tab)
Google Maps Platform and Mapbox are trademarks of their owners. MapIron (Wells Software Consulting LLC) isn't affiliated with or endorsed by either. Estimates use list prices only: discounts, credits, taxes and enterprise contracts aren't included. Spotted something out of date? Email hello@mapiron.com and we'll fix it.