Skip to content

RESTful GIS API

Our goal at the Port Authority is to provide programmable governance for the people and businesses we serve, and access to our data using RESTful JSON APIs that can be integrated into our partners' own systems to encourage innovation.


Available API Endpoints
Root URL: https://api.gbpa.com/gis/{resource}/{identifier}


Requests do not require authorization and should request application/json, with locale header if possible. You can test the API by using an IDE like Postman. Responses will follow the RESTful standard: 200 for success, 40x to indicate problems with your request, and 50x to indicate server issues.


  • GET / Paginated collection (index) of address resources.
    Params
    Name In Type Ex.
    page query string 1
    Example Request
    curl -H "Accept:application/json" https://api.gbpa.com/gis/addresses?page=1
    Example Response
    {
        "data": [
            {
                "guid": "e6a71a15-dd4a-11e7-8458-080027192ca4",
                "geohash": "dk8p5dzz8286",
                "block": "1",
                "parcel": "37",
                "num": "1-37",
                "prefix": "",
                "name": "Shannon",
                "suffix": "Drive",
                "title": "Shannon Drive",
                "address": "1-37 Shannon Drive",
                "city": "Lucaya",
                "lat": 26.55936553,
                "lon": -78.58553703,
                "coords": "26.55936553,-78.58553703"
            }
        ]
      }
    
  • GET /{guid} Single record of an address resource.
    Params
    Name In Type Ex.
    guid path string e6a71a15-dd4a-11e7-8458-080027192ca4
    Example Request
    curl -H "Accept:application/json" https://api.gbpa.com/gis/addresses/e6a71a15-dd4a-11e7-8458-080027192ca4
    Example Response
    {
        "data":         {
                "guid": "e6a71a15-dd4a-11e7-8458-080027192ca4",
                "geohash": "dk8p5dzz8286",
                "block": "1",
                "parcel": "37",
                "num": "1-37",
                "prefix": "",
                "name": "Shannon",
                "suffix": "Drive",
                "title": "Shannon Drive",
                "address": "1-37 Shannon Drive",
                "city": "Lucaya",
                "lat": 26.55936553,
                "lon": -78.58553703,
                "coords": "26.55936553,-78.58553703"
            }
      }
    
  • GET /search Paginated collection of keyword search results.
    Params
    Name In Type Ex.
    q query string
    Example Request
    curl -H "Accept:application/json" https://api.gbpa.com/gis/addresses/search?q=corner
    Example Response
    {
        "data": [
            {
                "guid": "e3e980c3-dd4a-11e7-8458-080027192ca4",
                "geohash": "dk8ncwxwyvzu",
                "block": "0",
                "parcel": "114",
                "num": "114",
                "prefix": "",
                "name": "Fig",
                "suffix": "Corner",
                "title": "Fig Corner",
                "address": "114 Fig Corner",
                "city": "Freeport",
                "lat": 26.53591927,
                "lon": -78.67348224,
                "coords": "26.53591927,-78.67348224"
            }
        ]
    }
    
  • GET /proximity Paginated collection of geospatial (nearby) search results.
    Params
    Name In Type Ex.
    lat query float 26.542098503330468
    lon query float -78.6446896931152
    Example Request
    curl -H "Accept:application/json" https://api.gbpa.com/gis/addresses/proximity?lat=26.542098503330468&lon=-78.6446896931152
    Example Response
    {
        "data": [
            {
              "guid": "e40fecf0-dd4a-11e7-8458-080027192ca4",
              "geohash": "dk8nfrgu26fk",
              "block": "16",
              "parcel": "25",
              "num": "16-25",
              "prefix": "",
              "name": "Indiaman",
              "suffix": "Road",
              "title": "Indiaman Road",
              "address": "16-25 Indiaman Road",
              "city": "Lucaya",
              "lat": 26.5423405,
              "lon": -78.64595933,
              "coords": "26.54234050,-78.64595933",
              "distance_degrees": 0.0012924937941984455,
              "distance_miles": 0.08918207179969274,
              "distance_km": 0.14346681115602744,
              "distance_meters": 143.5242754301175
            }
        ]
    }
    

Imagine Applications

Boundary Shapes / Lat/Lng Points / Desktop Files / Databases