# 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.

## 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](https://github.com/Software-Consulting/mapiron-migrate) 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](https://mapiron.com/docs/satellite-terrain) |
| `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](https://mapiron.com/tools/map-api-bill-calculator), or ask for a [bill rescue](https://mapiron.com/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.

**What about the Maps JavaScript API?**

Use MapLibre GL JS or Leaflet with MapIron tiles: see [MapLibre](https://mapiron.com/docs/maplibre) and [Leaflet](https://mapiron.com/docs/leaflet). The Places library, Street View and traffic layers have no MapIron equivalent.

## Get a MapIron key

Free in under a minute, no card. New accounts get higher trial limits free for 14 days.

Get a free key

See pricing

## Sources

Read on Nov 19, 2026. Prices and terms change, so follow the links before deciding.

- [Google Geocoding API: request and response](https://developers.google.com/maps/documentation/geocoding/requests-geocoding)
- [Google Maps Static API: developer guide](https://developers.google.com/maps/documentation/maps-static/start)
- [Google Maps Platform service specific terms](https://cloud.google.com/maps-platform/terms/maps-service-terms)

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](mailto:hello@mapiron.com) and we'll fix it.

---
Source: https://mapiron.com/migrate/google-maps · Map data © OpenStreetMap contributors · Index: https://mapiron.com/llms.txt
