Migration

Migrating from Mapbox Geocoding

Mapbox Geocoding returns results as a GeoJSON FeatureCollection, which is a deliberate choice that makes the output easy to hand straight to Mapbox GL or any other GeoJSON-aware mapping library. Each feature carries a center coordinate pair, a place_name string, and a context array describing the containing region, country, and postal code. Authentication is an access token, usually passed as a query parameter, and many teams also use the same token across their web map tiles and their geocoding calls.

That dual use of one token is worth noticing before a migration, because it means the geocoding call and the map rendering call are often more tangled together in application code than they first appear. Separating them cleanly, so the geocoding request can point at a new host while the map tiles stay wherever they are, is usually the first real decision to make.

My Geocode's Mapbox compatibility host reproduces the FeatureCollection structure, including the center, place_name, and context fields, so code built around response.features[0].center keeps working after the swap. Only the copyright, terms, and privacy text in the response differs from Mapbox's own. The field reference is at /compatibility/mapbox/.

A few practical notes for teams making this move:

  • If your front end calls Mapbox Geocoding directly from client-side JavaScript, moving that call to a server-side proxy first is worth considering regardless of which provider you land on, since it keeps API keys out of browser code
  • Authentication accepts an X-API-Key header, an Authorization: Bearer header, HTTP Basic auth, or a query parameter, so whichever style your existing Mapbox client uses for its access token should map onto one of these
  • If you rely on Mapbox's proximity or bounding box parameters to bias results toward a region, check the compatibility host's documentation for the equivalent parameter names before assuming they carry over unchanged

Pricing removes the token-tier structure that grows with usage tiers on many mapping platforms. Here, 2,500 requests a day are free with no key at all, and every key also carries its own 2,500 free requests a day counted per network. After that it is prepaid credit at €0.0001 per request or an Unlimited key at €50 a month, and every endpoint, including this compatibility host, costs the same amount.

Because Mapbox is frequently used alongside map tiles and static map images rather than for geocoding alone, it is worth being clear about scope: My Geocode is a geocoding, IP, timezone, elevation, and postal code lookup API, not a tile or basemap provider. Teams keeping their existing map rendering while moving only the address lookup to a new host should expect to run two providers side by side for a while, one for tiles and one for geocoding, which is a normal and stable way to split the work rather than a temporary state to rush past.