<!-- fivemad.com, Markdown source of https://fivemad.com/docs/tools/interactive-map -->
> Source: https://fivemad.com/docs/tools/interactive-map
> Section: Tools
> Tags: map, coordinates, vector3, vector4, pins, distance
> Tool: https://fivemad.com/tools/interactive-map
> Last updated: 2026-09-23
> Site map for assistants: https://fivemad.com/llms.txt

# Interactive Map

Find any spot on the GTA V map, copy exact vector3 and vector4 coordinates, drop pins, measure distances and share links to a location.

The Interactive Map is the whole GTA V map in your browser, with coordinates under the cursor. Click to drop a pin and copy it as `vector3` or `vector4`, measure a route, or share a link that opens the map on an exact spot. On a desktop you can switch to a 3D world and move to the place you are about to script with a freecam or on foot. It is for anyone who needs coordinates without starting the game: spawn points, blips, job locations, teleports, zones.

## What it is for

Most FiveM configs are full of coordinates. Getting them usually means joining your server, walking to the spot and printing `GetEntityCoords`. With the map you can pick rough positions for a whole job route in a minute, check the distance between two shops, or look up where a coordinate from a config actually is. For spots where height matters (a roof, under a bridge), use the 3D view or fine tune the z in game.

## Quick start

1. Open the tool. On a desktop it starts in the **3D world** at Legion Square; press **2D map** to see the flat map. On phones and tablets it opens the 2D map.
2. Drag to pan, scroll (or pinch) to zoom. The box in the bottom right corner shows `x, y` under the cursor, plus `z` when the ground height there is known.
3. With **Drop pins** active, click the map. A pin appears and is added to **Pins** on the right.
4. In the pin card, set **heading** if you need one, then press **vector3** or **vector4** to copy the line.
5. Paste it into your script or config.

## The 2D map

| Control | What it does |
| --- | --- |
| Drag | Pan the map. |
| Mouse wheel / pinch | Zoom, centred on the cursor. |
| **+** / **-** buttons (top right) | Zoom in and out one step. |
| Click | Drop a pin (**Drop pins** tool) or add a measure point (**Measure** tool). |
| Cursor box (bottom right) | `x, y` and `z` of the spot under the mouse. |
| Scale bar (bottom left) | Shows metres or kilometres at the current zoom. |

When you have been in the 3D view, a small white arrow on the 2D map shows where the 3D camera is and which way it looks.

### Drop pins

The default tool. Each click drops a pin at that spot with the ground height filled in. If the height is still loading when you click, the z is filled in about a second later. Pins draw a short line in the direction of their heading.

### Measure

Switch to **Measure** and click two or more points. The **Measure** card shows:

- **flat distance**: the length of the line on the map, point to point.
- **with height**: the same route including height differences.
- **points**: how many points you clicked.

Distances over 1000 m are shown in km. **Clear** starts over. The measure line stays on the map when you switch back to pins, until you clear it.

## Go to a place or coordinates

The search box at the top of the side panel does two things:

- **Places**: with an empty box you get a list of well known spots (Legion Square, Pillbox Hill Medical, Mission Row Police, Maze Bank Tower roof, Vespucci Beach, Del Perro Pier, Vinewood Sign, LS International Airport, Sandy Shores, Paleto Bay, Mount Chiliad, Fort Zancudo). Type to filter, click one (or press <kbd>Enter</kbd> for the first match) to jump there.
- **Coordinates**: paste a coordinate in any common format, for example `vector3(195.2, -933.8, 30.7)`, `vector4(...)`, `{x = ..., y = ..., z = ...}` or plain `195.2, -933.8, 30.7`. A **Go to x, y and pin it** button appears. Click it or press <kbd>Enter</kbd> to centre the map there and drop a pin, with the heading from a `vector4`.

This is the quickest way to answer "where is this coordinate from the config?".

## Pins

The **Pins** card lists every pin with its x, y, z. Pins are saved in your browser, so they are still there next time you open the map.

- Click a pin's coordinates to centre the map (or the 3D camera) on it.
- Click a pin card to make it active. The active pin is drawn larger on the map.
- The trash icon removes one pin, **Clear** removes all of them.

The active pin opens its editor:

| Field / button | What it does |
| --- | --- |
| **z** | Height. Filled in from the map, edit it if you know better (roofs, bridges, interiors). |
| **heading** | 0 faces north, 90 west, 180 south, 270 east, the same as `GetEntityHeading`. Values are wrapped into 0-360. |
| **vector3** | Copies `vector3(x, y, z)`, rounded to 2 decimals. |
| **vector4** | Copies `vector4(x, y, z, heading)`, heading rounded to 1 decimal. |
| **Link** | Copies a link that opens the map on this pin with the same heading. |
| **See in 3D** | Desktop only. Opens the 3D world standing at the pin, looking along its heading. |

### Share links

A link looks like `https://fivemad.com/tools/interactive-map#at=195.2,-933.8,29.7,90&zoom=6`. Opening it shows the 2D map centred on that spot and adds a pin labelled **Shared** (only once, even if you open the link again). Good for pointing a teammate at the exact spot you mean.

## The 3D world

Press **3D world** (desktop browser with mouse and keyboard) to leave the flat map and move through the world itself. It opens standing at the active pin, or, with no pin selected, above the area you were looking at on the 2D map. In 3D:

- Click the view to look around with the mouse, <kbd>Esc</kbd> releases it. Holding the right mouse button also works.
- <kbd>W</kbd> <kbd>A</kbd> <kbd>S</kbd> <kbd>D</kbd> move, <kbd>Shift</kbd> goes faster, <kbd>Space</kbd> up, <kbd>C</kbd> down, the mouse wheel sets the camera speed.
- **Freecam** and **Walk** switch the movement mode.
- **Pin here** (bottom left) drops a pin on the ground under the camera, with the camera's heading. Switch back to **2D map** to copy it.
- Picking a place or pasting coordinates in the search box teleports the camera above that spot.

Every key and the quality settings are in the [3D world](/docs/tools/world-3d) docs.

## Examples

A pin copied as `vector4` works straight away as a spawn point:

```lua title="client.lua"
local spawn = vector4(195.2, -933.8, 29.7, 144.0)

RegisterCommand('legion', function()
    local ped = PlayerPedId()
    SetEntityCoords(ped, spawn.x, spawn.y, spawn.z, false, false, false, false)
    SetEntityHeading(ped, spawn.w)
end, false)
```

A `vector3` for a map blip:

```lua title="client.lua"
local shop = vector3(25.7, -1347.3, 29.5)

CreateThread(function()
    local blip = AddBlipForCoord(shop.x, shop.y, shop.z)
    SetBlipSprite(blip, 52)
    SetBlipAsShortRange(blip, true)
    BeginTextCommandSetBlipName("STRING")
    AddTextComponentSubstringPlayerName("24/7")
    EndTextCommandSetBlipName(blip)
end)
```

A list of pins pasted into a config for a job route:

```lua title="config.lua"
Config.Deliveries = {
    vector3(-1300.0, -1600.0, 3.3),
    vector3(1860.0, 3678.0, 32.5),
    vector3(-287.0, 6220.0, 30.5),
}
```

## Tips

- The z under the cursor is the top surface: ground, road or roof. For a spot under a bridge or inside a building, fix the z by hand or check it in the 3D view.
- `GetEntityCoords(PlayerPedId())` returns a point about 1 m above the ground (the pelvis). Map pins sit on the ground. For `SetEntityCoords` either is fine; for props and markers, the ground value is what you want.
- Use the **Measure** tool to size `#(a - b) < radius` checks, zones and delivery payouts before you write them.
- Pins are only stored in this browser. Copy what you need, or use **Link** to move a pin to another device.

> [!TIP]
> The [YMAP Builder](/tools/ymap-builder) imports `vector3` and `vector4` lines directly, so a set of pins can become a set of placed props.

## Limitations

- Heights are accurate to a few metres. Always check spawn heights on roofs, bridges and stairs in game.
- Cayo Perico and North Yankton are not on the map.
- The 3D view needs a desktop browser with WebGL 2, a mouse and a keyboard. On phones the 2D map works fully.
- Pins, measure points and links stay in your browser. Nothing is uploaded.

## Related tools

- [3D world](/docs/tools/world-3d)
- [YMAP Builder](/docs/tools/ymap-builder)
- [Blip, Marker & Checkpoint Browser](/docs/tools/blip-marker-browser)
- [Objects / Props List](/docs/tools/objects-list)