Overview

api.gtadb.org provides a suite of map and geo service APIs for GTA IV, V and VI.

Plain HTTP/GET unless otherwise stated.

Current status: experimental.

GTADB Elevation API

Get the elevation at a given point:

https://api.gtadb.org/elevation?gta=6&x=-3778.98&y=712.94&key=API_KEY

{
    "results": [
        {
            "elevation": 3.246,
            "location": [-3778.98, 712.94]
        }
    ],
    "status": "OK"
}

GTADB Geocoding API

Get structured geodata for a given query:

https://api.gtadb.org/geocode?gta=6&address=lombank&key=API_KEY

Get structured geodata for a given point:

https://api.gtadb.org/geocode?gta=6&x=-700&y=1200&key=API_KEY

{
    "results": [
        {
            "address_components": [
                    "long_name": "Jack of Hearts",
                    "short_name": "Jack of Hearts",
                    "types": ["establishment", "point of interest"]
                },
                {
                    "long_name": "Miramar Drive",
                    "short_name": "Miramar Dr",
                    "types": ["route"]
                },
                {
                    "long_name": "Crosstown",
                    "short_name": "Crosstown",
                    "types": ["neighborhood", "political"]
                },
                {
                    "long_name": "Vice City",
                    "short_name": "Vice City",
                    "types": ["locality", "political"]
                },
                {
                    "long_name": "Vice-Dale County",
                    "short_name": "Vice-Dale County",
                    "types": ["administrative_area_level_2", "political"]
                },
                {
                    "long_name": "Leonida",
                    "short_name": "LE",
                    "types":["administrative_area_level_1", "political"]
                },
                {
                    "long_name": "United States of America",
                    "short_name": "USA",
                    "types": ["country", "political"]
                }
            ],
            "formatted_address": "Jack of Hearts, Miramar Dr, Crosstown, Vice City, Vice-Dale County, LE, USA",
            "geometry": {
                "bounds": {
                    "northeast": [-585.939, 1294.937],
                    "southwest": [-785.939, 1094.937]
                },
                "location": [-685.939, 1194.937]
            },
            "gtadb_id": "L172"
        }
    ],
    "status": "OK"
}

GTADB Landmarks API

Get all landmarks:

https://api.gtadb.org/landmarks?gta=6&key=API_KEY

{
    "results": [
        {"id": "L1", "ig_coordinates": [1409.401, 2803.214], "types": ["hotel"]},
        {"id": "L2", "ig_coordinates": [1491.645, 2633.302], "types": ["residential"]},
        {"id": "L3", "ig_coordinates": [1541.925, 2562.866], "types": ["hotel"]},
        [...]
    ],
    "status": "OK"
}

Get data for a given landmark:

https://api.gtadb.org/landmarks?gta=6&id=L25&key=API_KEY

{
    "results": [
        {
            "ig_address": "Dominion Hotel, Shore Dr, Ocean Beach, Vice Beach, Vice-Dale County, LE, USA",
            "ig_coordinates": [2007.5, 907],
            "ig_photo": "https://raw.githubusercontent.com/rolux/gtadb.org/main/map/photos/6/L25,ig.jpg",
            "rl_address": "Cardozo South Beach, 1300 Ocean Dr, Miami Beach, FL 33139, USA",
            "rl_coordinates": [25.7842292, -80.1302691],
            "rl_photo": "https://raw.githubusercontent.com/rolux/gtadb.org/main/map/photos/6/L25,rl.jpg",
            "types": ["hotel"]
        }
    ],
    "status": "OK"
}

GTADB Maps JavaScript API

Coming soon.

GTADB Static Maps API

Get a static map image with a given center (in world coordinates), size (in pixels) and scale (in pixels per meter):

https://api.gtadb.org/staticmap?gta=6&x=0&y=0&w=1000&h=1000&scale=0.5&key=API_KEY

GTADB Routes API

Coming soon.

Authentication

Currently none.

Rate limits

Currently none.

Terms of Service

Currently none.