Documentation

Every request to the MapFramer API requires an Authorization token. This token is issued upon account creation and identifies your rate limits and plan.

⚠️ Security: Never expose your API token in client-side code. Always call the API from your backend.

Converts a Google Maps short link into structured location data and a coordinate-precise embed URL.

curl -X POST https://mapframer.dev/api/v1/resolve \
  -H "Authorization: Bearer mf_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://maps.app.goo.gl/xxx"}'

MapFramer uses a unique Coordinate-First embedding strategy. We resolve the name of a place but force the pin to exact coordinates. This avoids the common "Multiple Results" list that often plagues generic name-based embeds.

function Map({ embedUrl }) {
  return (
    <iframe
      src={embedUrl}
      width="100%"
      height="450"
      style={{ border: 0, borderRadius: '16px' }}
      loading="lazy"
      allowFullScreen
    />
  );
}

Note: We recommend storing the `embedUrl` in your database during the admin save step instead of calling the API on every page view.