Geodesignhub API

API Endpoint
https://www.geodesignhub.com/api/v1

Geodesignhub API exposes a number of functionalities of the platform for developers to build applications and plugins. The API is a JSON-based and provides a REST interface, it uses standard HTTP response codes to indicate API errors.

Token Authentication

Geodesignhub exposes project objects and information via the API. These are associated with individual user accounts via Token Authentication. Since the token is linked to the user, all the projects that the user is part of are accessible using the token. Currently, tokens have an expiry of six months after which a new token can be issued.

You can get your Token by opening the API page on Geodesignhub.

Access

Geodesignhub supports only https:// connections via the API. http:// connections will be given a automatic HTTP 301 response. In some cases, http:// queries may be dropped by the server, you may get time out or end point not reachable errors.

Pagination

Geodesignhub API responses are generally paginated. The default page size is 10; you can alter this by adding the page_size parameter to your request.

Response Codes

The API uses standard HTTP response codes to communicate the status of the request. In general, 2xx codes signify success and 4xx codes signify failure, and these codes are generally associated with an invalid parameter being provided in the request. A 5xx code is a general server failure on our side. Please contact our support team if you encounter 5xx errors.

Projects API

Resources related to projects on Geodesignhub.

Projects Collection

GET https://www.geodesignhub.com/api/v1/projects/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
[
  {
    "id": "5c84b38a16ebeed0",
    "projecttitle": "Cagliari geodesign",
    "projectdesc": "Alternative futures for Metro Cagliari",
    "startdate": "2023-06-14",
    "projecttype": "free",
    "external_connection": "none"
  },
  {
    "id": "f05bf015a514a67c",
    "projecttitle": "Phoenix Geodesign",
    "projectdesc": "Alternative futures for Phoenix, Arizona",
    "startdate": "2023-06-14",
    "projecttype": "free",
    "external_connection": "none"
  }
]

List all projects
GET/projects/

Returns a list of projects that has the current user as a member.

Latest Project Details

GET https://www.geodesignhub.com/api/v1/projects/latest/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
[
  {
    "id": "5c84b38a16ebeed0",
    "projecttitle": "Cagliari geodesign",
    "projectdesc": "Alternative futures for Metro Cagliari",
    "startdate": "2023-06-14",
    "projecttype": "free",
    "external_connection": "none"
  }
]

List all projects
GET/projects/latest/

Returns with the details of the latest created project that has the current user as a member.

Project Creation

POST https://www.geodesignhub.com/api/v1/projects/create/
Requestsexample 1
Headers
Content-Type: application/json
Authorization: Token ABC123
Body
{
  "creation_code": "3PRHNU",
  "project_title": "Dublin Geodesign",
  "project_description": "Alternative futures for Ranelagh",
  "map_bounds": "-6.257314682006836,53.32508049349382,-6.250877380371094,53.328925153953186",
  "map_center": "-6.254,53.327",
  "zoom_level": 16,
  "systems": [
    {
      "name": "ENE",
      "tag": "POR",
      "display": "Energy",
      "color": "#ab507e",
      "cost": 40000
    },
    {
      "name": "AG",
      "tag": "POR",
      "display": "Agriculture",
      "color": "#d9cd91",
      "cost": 4000
    }
  ],
  "tags": [
    {
      "tag": "Green Housing",
      "code": "0.5"
    }
  ],
  "plugins": []
}
Responses201
Headers
Content-Type: application/json
Body
{
  "message": "New Project and systems created, they will appear on user1's profile page"
}

Create New Project
POST/projects/create/

Create a new project in Geodesignhub, a set of data is requried to create a project, please review below

  • creation_code A Geodesignhub project creation code, if you don’t have one, please contact your project administrator
    • project_title Title of the project, it will be displayed at the top of every project
    • project_description Title of the project, it will be displayed at the top of every project
    • map_bounds Represents a rectangular geographical area on a map.
    • map_center Represents a center as comma seperated Latitude,Longitude center
    • zoom_level Sets the zoom of the map
    • systems A list of systems that will be created in the project. Each object should have a name, display, color and cost value for the system. Maximum nine systems can be provided.
    • tags A list of tags that can be added to Diagrams. Each object should have a tag and code property both as strings.
    • plugins A list of plugin UUIDs to attach to the project, you can use the the user interface to add them as well.

IGC Project Creation

POST https://www.geodesignhub.com/api/v1/projects/create-igc-project/
Requestsexample 1
Headers
Content-Type: application/json
Authorization: Token ABC123
Body
{
    "gpl_project_id": "ifY96Z8u1zvbd8Bb24gaaBqgD7l3bag8", 
    "project_title" : "Dublin Geodesign",
    "project_description":"Alternative futures for Ranelagh",
    "map_bounds": "-6.257314682006836,53.32508049349382,-6.250877380371094,53.328925153953186",
    "map_center" : "-6.254,53.327",
    "zoom_level":16,
    "systems": [{"name":"ENE", "tag":"POR", "display":"Energy", "color":"#ab507e", "cost":40000}, {"name":"AG", "tag":"POR", "display":"Agriculture", "color":"#d9cd91", "cost":4000}]
    "tags": [{"tag": "Green Housing","code": "0.5"}],
    "plugins":[]
}
Responses201
Headers
Content-Type: application/json
Body
{
  "message": "New Project and systems created, they will appear on user1's profile page"
}

Create New IGC Project
POST/projects/create-igc-project/

Create a new project in Geodesignhub, a set of data is requried to create a project, please review below:

  • gpl_project_id A Geoplanner project ID, contact your IGC administrator for this code if you dont have it.
    • project_title Title of the project, it will be displayed at the top of every project
    • project_description Title of the project, it will be displayed at the top of every project
    • map_bounds Represents a rectangular geographical area on a map.
    • map_center Represents a center as comma seperated Latitude,Longitude center
    • zoom_level Sets the zoom of the map
    • systems A list of systems that will be created in the project. Each object should have a name, display, color and cost value for the system. Maximum nine systems can be provided.
    • tags A list of tags that can be added to Diagrams. Each object should have a tag and code property both as strings.
    • plugins A list of plugin UUIDs to attach to the project, you can use the the user interface to add them as well.

Project Detail

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "id": "5c84b38a16ebeed0",
  "projecttitle": "lego geodesign",
  "projectdesc": "lgd",
  "startdate": "2016-11-15",
  "projecttype": "free",
  "external_connection": "none"
}

Get a single project
GET/projects/{projectid}/

Returns the title and description of the selected project. Project name is a sixteen character hash of the project.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

Project Members

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/members/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "members": [
    {
      "username": "ufeusr1"
    },
    {
      "username": "ufeusr2"
    },
    {
      "username": "ufeusr3"
    }
  ]
}

List members of a project
GET/projects/{projectid}/members/

Returns a list of all the usernames that are a part of the project.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

Project Study Area Bounds

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/bounds/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "bounds": "-0.11569976806640624,51.49624032118747,-0.06420135498046875,51.52829020697338"
}

Get project bounds
GET/projects/{projectid}/bounds/

Returns a string with bounding box for the project study area coordinates in a southwest_lng,southwest_lat,northeast_lng,northeast_lat format.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

Project Plugins

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/plugins/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
[
  {"id": "b08bd2e7-0595-481b-95c9-86c39b57d3db" , "description":"Buildings 3D Viewer"},
  {"id":"3fef8104-c4b2-47fd-86ca-4ebcbf29ef13", "description":"Dashboard"},
]

Get project plugins
GET/projects/{projectid}/plugins/

Returns the id and description of all the plugins that are added / linked to the project

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

POST https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/plugins/
Requestsexample 1
Headers
Authorization: Token ABC123
Body
[
  "14c338ae-ab5f-47c9-b067-e40710dc29c9",
  "c467ad77-087d-481e-9f09-7afafc2720a0"
]
Responses200
Headers
Content-Type: application/json
Body
{
  "message": "2 plugins added successfully"
}

Add project Plugins
POST/projects/{projectid}/plugins/

Add plugins with the specified ID to the project, any existing plugins will be removed

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

Project Study Area Center

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/center/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "center": "-0.1567,51.5041"
}

Get project center
GET/projects/{projectid}/center/

Returns a string with center of the study area in longitude,latitude format.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

Project Constraints

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/constraints/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "geojson": {
    "type": "FeatureCollection",
    "features": [
      {
        "geometry": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -0.13458251953125,
                51.49891200625809
              ],
              [
                -0.11260986328124999,
                51.48651406499528
              ],
              [
                -0.1702880859375,
                51.473257364513714
              ],
              [
                -0.1847076416015625,
                51.46812470399791
              ],
              [
                -0.17990112304687497,
                51.50062180251775
              ],
              [
                -0.18745422363281247,
                51.5091698216777
              ],
              [
                -0.1888275146484375,
                51.5177162373547
              ],
              [
                -0.17852783203125,
                51.52327054772943
              ],
              [
                -0.17234802246093747,
                51.52327054772943
              ],
              [
                -0.13458251953125,
                51.49891200625809
              ],
              [
                -0.13458251953125,
                51.49891200625809
              ]
            ]
          ]
        },
        "type": "Feature",
        "properties": {
          "areatype": "constraints",
          "author": "ufeusr1",
          "color": "#343434",
          "diagramid": 2,
          "sysid": 1
        }
      }
    ]
  },
  "sysid": 1,
  "rank": 0,
  "id": 0,
  "description": "No Description Added. Please add one.",
  "length": 0,
  "area": 16791.702
}

Get project constraints
GET/projects/{projectid}/constraints/

Returns a GeoJSON geometry of constraints set within the project area.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

Project Boundaries

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/boundaries/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "geojson": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "properties": {
          "bname": "Boundary 1",
          "areatype": "boundaries",
          "color": "#a6cee3",
          "author": "ufeusr1"
        },
        "geometry": {
          "coordinates": [
            [
              [
                38.989019,
                37.180636
              ],
              [
                38.989191,
                37.166958
              ],
              [
                39.004469,
                37.166411
              ],
              [
                39.006529,
                37.182414
              ],
              [
                38.989019,
                37.180636
              ]
            ]
          ],
          "type": "Polygon"
        }
      },
      {
        "type": "Feature",
        "properties": {
          "bname": "Boundary 1",
          "areatype": "boundaries",
          "color": "#a6cee3",
          "author": "ufeusr1"
        },
        "geometry": {
          "coordinates": [
            [
              [
                39.013395,
                37.182277
              ],
              [
                39.011679,
                37.166
              ],
              [
                39.032106,
                37.167368
              ],
              [
                39.03039,
                37.18214
              ],
              [
                39.013395,
                37.182277
              ]
            ]
          ],
          "type": "Polygon"
        }
      }
    ]
  },
  "description": "First Boundaries"
}

Get project boundaries
GET/projects/{projectid}/boundaries/

Returns a GeoJSON geometry of the first boundary set within the project area.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

Project Second Boundaries

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/secondboundaries/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "geojson": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "properties": {
          "bname": "Boundary 1",
          "areatype": "boundaries",
          "color": "#a6cee3",
          "author": "ufeusr1"
        },
        "geometry": {
          "coordinates": [
            [
              [
                38.989019,
                37.180636
              ],
              [
                38.989191,
                37.166958
              ],
              [
                39.004469,
                37.166411
              ],
              [
                39.006529,
                37.182414
              ],
              [
                38.989019,
                37.180636
              ]
            ]
          ],
          "type": "Polygon"
        }
      },
      {
        "type": "Feature",
        "properties": {
          "bname": "Boundary 1",
          "areatype": "boundaries",
          "color": "#a6cee3",
          "author": "ufeusr1"
        },
        "geometry": {
          "coordinates": [
            [
              [
                39.013395,
                37.182277
              ],
              [
                39.011679,
                37.166
              ],
              [
                39.032106,
                37.167368
              ],
              [
                39.03039,
                37.18214
              ],
              [
                39.013395,
                37.182277
              ]
            ]
          ],
          "type": "Polygon"
        }
      }
    ]
  },
  "description": "Second Boundaries"
}

Get second project boundaries
GET/projects/{projectid}/secondboundaries/

Returns a GeoJSON geometry of second boundaries set within the project area. (Upto two boundaries can be set in a project)

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

Tags API

Resources related to tags on Geodesignhub.

Create Tags

POST https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/tags/create/
Requestsexample 1
Headers
Authorization: Token ABC123
Body
{
  "tags": [
    {
      "tag": "Hello World",
      "code": "1.2.2"
    }
  ]
}
Responses200
Headers
Content-Type: application/json
Body
{
  "status": "Tags created successfully"
}

Bulk Create project tags
POST/projects/{projectid}/tags/create/

Creates multiple tags for a project. Using this endpoint, you can create multiple tags for a project.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

List Tags

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/tags/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
[
    {
        "id": "a95fcf52-b2df-46a8-9f70-dab4e7eebaa9",
        "tag": "house",
        "slug": "house",
        "code": "3.4", 
        "diagrams": []
    },
    {
        "id": "d5ea9a83-ca25-4f2a-b077-6480055e4835",
        "tag": "home",
        "slug": "home",
        "code": "0.4",
        "diagrams": []
    },
    {
        "id": "12697faa-6dbf-4b47-9696-6108c7e4e99e",
        "tag": "holiday",
        "slug": "holiday",
        "code": "",                 
        "diagrams": [23]
    },
    {
        "id": "b88bc74b-58fb-4a38-88b9-16a679a4b783",
        "tag": "housing",
        "slug": "housing"
        "code": "", 
        "diagrams": [25]
    }
]

Get all project tags
GET/projects/{projectid}/tags/

Returns a JSON object detailing all the tags associated with a project, a diagram can have multiple tags associated with it.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

Diagrams API

Resources related to diagrams on Geodesignhub.

Diagrams Collection

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/diagrams/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
[
  {
    "id": 7,
    "worlddescription": "ase",
    "author": "ufeusr1",
    "created_at": "2018-08-26T20:53:25.838663",
    "rank": 1,
    "sysid": 2
  },
  {
    "id": 8,
    "worlddescription": "ce",
    "author": "ufeusr1",
    "created_at": "2018-01-26T20:53:25.838663",
    "rank": 1,
    "sysid": 1
  },
  {
    "id": 9,
    "worlddescription": "32",
    "author": "ufeusr1",
    "created_at": "2018-02-02T20:53:25.838663",
    "rank": 2,
    "sysid": 1
  }
]

List project diagrams
GET/projects/{projectid}/diagrams/

Returns all the diagrams for the project by ID and description.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

All Diagrams

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/diagrams/all/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
[
  {
    "geojson": {
      "type": "FeatureCollection",
      "features": [
        {
          "geometry": {
            "type": "Polygon",
            "coordinates": [
              [
                [
                  -0.09514331817626952,
                  51.51555307745177
                ],
                [
                  -0.09394168853759766,
                  51.51523260058079
                ],
                [
                  -0.08668899536132812,
                  51.51549966479653
                ],
                [
                  -0.0856161117553711,
                  51.515659902574384
                ],
                [
                  -0.08085250854492186,
                  51.51547295844541
                ],
                [
                  -0.08020877838134766,
                  51.51531272000991
                ],
                [
                  -0.07797718048095703,
                  51.51437798456801
                ],
                [
                  -0.07746219635009766,
                  51.51395067054886
                ],
                [
                  -0.07741928100585936,
                  51.51352335252112
                ],
                [
                  -0.07784843444824219,
                  51.5129891993494
                ],
                [
                  -0.07973670959472656,
                  51.51280224425956
                ],
                [
                  -0.0832986831665039,
                  51.51309603048481
                ],
                [
                  -0.08703231811523438,
                  51.51309603048481
                ],
                [
                  -0.08870601654052734,
                  51.5129891993494
                ],
                [
                  -0.09029388427734374,
                  51.51325627671818
                ],
                [
                  -0.09162425994873047,
                  51.51365688983539
                ],
                [
                  -0.0960874557495117,
                  51.51456493319091
                ],
                [
                  -0.09724617004394531,
                  51.514992241447835
                ],
                [
                  -0.0972890853881836,
                  51.51568660881589
                ],
                [
                  -0.09552955627441406,
                  51.51571331504175
                ],
                [
                  -0.09514331817626952,
                  51.51555307745177
                ],
                [
                  -0.09514331817626952,
                  51.51555307745177
                ]
              ]
            ]
          },
          "type": "Feature",
          "properties": {
            "areatype": "project",
            "author": "ufeusr1",
            "color": "#071ac8",
            "diagramid": 5,
            "sysid": 1,
            "systag": "Small buildings, low density housing"
          }
        }
      ]
    },
    "sysid": 1,
    "rank": 1,
    "id": 1,
    "description": "testing",
    "length": 0,
    "area": 16791.702,
    "cost_override": 100,
    "cost_override_type": "total",
    "building_data": {
      "storeys_above_ground": 14,
      "storeys_below_ground": 0
    },
    "notes": "",
    "created_at": "2018-08-26 20:57:02",
    "start_date": "2020-02-26",
    "end_date": "2022-02-22",
    "additional_metadata": {},
    "tag_codes": "wp6sw"
  },
  {
    "geojson": {
      "type": "FeatureCollection",
      "features": [
        {
          "geometry": {
            "type": "Polygon",
            "coordinates": [
              [
                [
                  -0.1064300537109375,
                  51.5212411667077
                ],
                [
                  -0.07432937622070312,
                  51.50927666176991
                ],
                [
                  -0.06299972534179688,
                  51.505537109466715
                ],
                [
                  -0.06282806396484375,
                  51.50468231156
                ],
                [
                  -0.06420135498046875,
                  51.504148054725356
                ],
                [
                  -0.07656097412109375,
                  51.50607135001545
                ],
                [
                  -0.08737564086914062,
                  51.5089561407416
                ],
                [
                  -0.09990692138671875,
                  51.51066556016948
                ],
                [
                  -0.1078033447265625,
                  51.51087923308819
                ],
                [
                  -0.10951995849609375,
                  51.51525930707282
                ],
                [
                  -0.11484146118164062,
                  51.522522891558964
                ],
                [
                  -0.11243820190429688,
                  51.522629700334875
                ],
                [
                  -0.1064300537109375,
                  51.5212411667077
                ],
                [
                  -0.1064300537109375,
                  51.5212411667077
                ]
              ]
            ]
          },
          "type": "Feature",
          "properties": {
            "areatype": "policy",
            "author": "ufeusr1",
            "color": "#071ac8",
            "diagramid": 7,
            "sysid": 1,
            "systag": "Small buildings, low density housing"
          }
        }
      ]
    },
    "sysid": 1,
    "rank": 2,
    "id": 2,
    "description": "new polciy",
    "length": 0,
    "area": 16791.702,
    "cost_override": 0,
    "cost_override_type": "total",
    "building_data": {
      "storeys_above_ground": 14,
      "storeys_below_ground": 0
    },
    "notes": "",
    "created_at": "2018-08-26 20:57:02",
    "start_date": "2020-02-26",
    "end_date": "2022-02-22",
    "additional_metadata": {},
    "tag_codes": "wp6sw"
  },
  {
    "geojson": {
      "type": "FeatureCollection",
      "features": [
        {
          "geometry": {
            "type": "Polygon",
            "coordinates": [
              [
                [
                  -0.09479999542236328,
                  51.51472517425703
                ],
                [
                  -0.09415626525878906,
                  51.511760623284765
                ],
                [
                  -0.09419918060302733,
                  51.509837568143645
                ],
                [
                  -0.09758949279785156,
                  51.510558723334285
                ],
                [
                  -0.09883403778076172,
                  51.51103948711957
                ],
                [
                  -0.09836196899414062,
                  51.511760623284765
                ],
                [
                  -0.0990915298461914,
                  51.515900258184224
                ],
                [
                  -0.09492874145507812,
                  51.515900258184224
                ],
                [
                  -0.09479999542236328,
                  51.51472517425703
                ],
                [
                  -0.09479999542236328,
                  51.51472517425703
                ]
              ]
            ]
          },
          "type": "Feature",
          "properties": {
            "areatype": "project",
            "author": "ufeusr1",
            "color": "#fc1999",
            "diagramid": 8,
            "sysid": 2,
            "systag": "Large buildings, Industry, commerce"
          }
        }
      ]
    },
    "sysid": 2,
    "rank": 1,
    "id": 1,
    "description": "new project",
    "length": 0,
    "area": 16791.702,
    "cost_override": 100,
    "cost_override_type": "total",
    "building_data": {
      "storeys_above_ground": 14,
      "storeys_below_ground": 0
    },
    "notes": "",
    "created_at": "2018-08-26 20:57:02",
    "start_date": "2020-02-26",
    "end_date": "2022-02-22",
    "additional_metadata": {},
    "tag_codes": "wp6sw"
  }
]

Get details of all diagrams
GET/projects/{projectid}/diagrams/all/

Returns the a list of Diagram geometries and properties for all the diagrams in the project.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

All Diagram Details

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/diagrams/all/details/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
[
      {
        "sysid": 1,
        "rank": 1,
        "id": 1,
        "description": "testing",
        "length": 0,
        "area": 16791.702,
        "cost_override": 100,
        "cost_override_type": "total",        
        "building_data": {
            "storeys_above_ground": 14,
            "storeys_below_ground": 0
        },
        "notes": "",        
        "additional_metadata": {},
        "created_at": "2018-08-26 20:57:02",
        "start_date": "2020-02-26",
        "end_date": "2022-02-22"
      },
      {
        "sysid": 1,
        "rank": 2,
        "id": 2,
        "description": "new polciy",
        "length": 0,
        "area": 16791.702,
        "cost_override": 0,
        "cost_override_type": "total",        
        "building_data": {
            "storeys_above_ground": 14,
            "storeys_below_ground": 0
        },
        "notes": "",       
        "additional_metadata": {},            
        "created_at": "2018-08-26 20:57:02",
        "start_date": "2020-02-26",
        "end_date": "2022-02-22"
      },
      {
        "sysid": 45,
        "rank": 2,
        "id": 2,
        "description": "test",
        "type": "project",
        "length": 0.0,
        "area": 5691.222,
        "fundingtype": "public",
        "cost_override_type": "per hectare.",
        "cost_override": 0.0,
        "created_at": "2020-08-24 19:25:57",
        "building_data": {},
        "notes": "",
        "additional_metadata": {},,
        "start_date": "2020-02-26",
        "end_date": "2022-02-22",
        "additional_metadata": {},
        "tag_codes": "wp6sw"
      }
    ]

Get details of all diagrams
GET/projects/{projectid}/diagrams/all/details/

Returns the a list of Diagram properties (without Geometries) for all the diagrams in the project.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

Diagram Detail

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/diagrams/12/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "geojson": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "properties": {
          "areatype": "project",
          "color": "#ffcc00",
          "systag": "Small buildings, low density housing",
          "diagramid": 155,
          "sysname": "LDH",
          "author": "ufeusr1"
        },
        "geometry": {
          "coordinates": [
            [
              [
                -6.255365,
                53.327752
              ],
              [
                -6.255408,
                53.32691
              ],
              [
                -6.254233,
                53.326839
              ],
              [
                -6.254147,
                53.327739
              ],
              [
                -6.255365,
                53.327752
              ]
            ]
          ],
          "type": "Polygon"
        }
      }
    ]
  },
  "sysid": 48,
  "rank": 2,
  "id": 2,
  "description": "new park",
  "type": "project",
  "length": 0,
  "area": 7733.067,
  "fundingtype": "public",
  "cost_override_type": "per hectare.",
  "cost_override": 0,
  "created_at": "2020-03-06 12:50:32",
  "start_date": "2020-02-26",
  "end_date": "2022-02-22",
  "notes": "",
  "additional_metadata": {},
  "building_data": {
    "storeys_above_ground": 95,
    "storeys_below_ground": -10
  },
  "tag_codes": "wp6sw"
}

Get details of a diagram
GET/projects/{projectid}/diagrams/{diagramid}/

Returns the a GeoJSON feature collection geometry of the diagram that is passed in the diagram ID.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

diagramid
integer (required) Example: 12

The ID of the diagram in the form of an integer

POST https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/diagrams/12/
Requestsexample 1

A object called “additional_metadata” must be provided

  • Tags tag_codes: List of Code ID strings

  • Additional Metadata additional_metadata: Free form JSON object

  • Diagram Title title: String

  • Start Date start_date: Time represented as simplified extended ISO format (ISO 8601), which is always 24 or 27 characters long (YYYY-MM-DDTHH:mm:ss.sssZ or ±YYYYYY-MM-DDTHH:mm:ss.sssZ

  • End Date end_date: Time represented as simplified extended ISO format (ISO 8601), which is always 24 or 27 characters long (YYYY-MM-DDTHH:mm:ss.sssZ or ±YYYYYY-MM-DDTHH:mm:ss.sssZ

Headers
Content-Type: application/json
Authorization: Token ABC123
Body
{
  "additional_metadata": {
    "id": "ca665187-6cfd-40a2-8cbf-3247d73c55f3"
  },
  "tag_codes": [
    "1.3.4"
  ],
  "title": "New Title",
  "start_date": "2020-01-28T00:00:00.000Z",
  "end_date": "2021-01-28T00:00:00.000Z"
}
Responses200400
Headers
Content-Type: application/json
Body
{
  "status": "Diagram properties updated successfully"
}
Headers
Content-Type: application/json
Body
{
  "status": "Processing unsuccessful. Tag ID provided refers to a tag not in the project."
}

Bulk Update properties of a diagram
POST/projects/{projectid}/diagrams/{diagramid}/

Bulk update selected properties of a diagram. Currently, five properties are supported:

  • Tags (tag_codes): List of Code ID strings

  • Additional Metadata (additional_metadata): Free form JSON object

  • Diagram Title (title): String

  • Start Date (start_date): Time represented as simplified extended ISO format (ISO 8601), which is always 24 or 27 characters long (YYYY-MM-DDTHH:mm:ss.sssZ or ±YYYYYY-MM-DDTHH:mm:ss.sssZ

  • End Date (end_date): Time represented as simplified extended ISO format (ISO 8601), which is always 24 or 27 characters long (YYYY-MM-DDTHH:mm:ss.sssZ or ±YYYYYY-MM-DDTHH:mm:ss.sssZ

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

diagramid
integer (required) Example: 12

The ID of the diagram in the form of an integer

Diagram Tags Detail

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/diagrams/12/tags/
Requestsexample 1
Headers
Content-Type: application/json
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
[
  {
    "id": "a95fcf52-b2df-46a8-9f70-dab4e7eebaa9",
    "tag": "house",
    "slug": "house",
    "code": "1.3.4",
    "diagrams": [
      23,
      22
    ]
  }
]

Get all Tags associated with a diagram
GET/projects/{projectid}/diagrams/{diagramid}/tags/

Returns the a JSON detailing the tags associated / linkedbo a diagram for the that is passed in the diagram ID.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

diagramid
integer (required) Example: 12

The ID of the diagram in the form of an integer

POST https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/diagrams/12/tags/
Requestsexample 1
Headers
Authorization: Token ABC123
Body
[
  "8a0abf8b-5bbc-4a1b-ac80-872291daed9f"
]
Responses200400
Headers
Content-Type: application/json
Body
{
  "status": "Tag updated successfully"
}
Headers
Content-Type: application/json
Body
{
  "status": "Processing unsuccessful. Tag ID provided refers to a tag not in the project."
}

Update all Tags associated with a diagram
POST/projects/{projectid}/diagrams/{diagramid}/tags/

Updates the tags associated with a diagram by assigning the the tag IDs passed in the request body.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

diagramid
integer (required) Example: 12

The ID of the diagram in the form of an integer

Diagram Tags Detail

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/diagrams/12/tags/codes/
Requestsexample 1
Headers
Content-Type: application/json
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
[
  {
    "id": "a95fcf52-b2df-46a8-9f70-dab4e7eebaa9",
    "tag": "house",
    "slug": "house",
    "code": "1.3.4",
    "diagrams": [
      23,
      22
    ]
  }
]

Get all Tags associated with a diagram (Tag code)
GET/projects/{projectid}/diagrams/{diagramid}/tags/codes/

Returns the a JSON detailing the tags associated / linked to a diagram for the that is passed in the diagram ID.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

diagramid
integer (required) Example: 12

The ID of the diagram in the form of an integer

POST https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/diagrams/12/tags/codes/
Requestsexample 1
Headers
Authorization: Token ABC123
Body
[
  "1.3.4"
]
Responses200400
Headers
Content-Type: application/json
Body
{
  "status": "Tag updated successfully"
}
Headers
Content-Type: application/json
Body
{
  "status": "Processing unsuccessful. Tag ID provided refers to a tag not in the project."
}

Update Tags associated with a diagram (Tag code)
POST/projects/{projectid}/diagrams/{diagramid}/tags/codes/

Updates the tags associated with a diagram by assigning the the tag code passed in the request body.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

diagramid
integer (required) Example: 12

The ID of the diagram in the form of an integer

Diagram Notes Detail

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/diagrams/12/notes/
Requestsexample 1
Headers
Content-Type: application/json
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "id": "54",
  "notes": "This housing project is already funded"
}

Get all Notes associated with a diagram
GET/projects/{projectid}/diagrams/{diagramid}/notes/

Returns the a JSON object detailing the notes associated / linked to a diagram that is passed in the diagram ID parameter.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

diagramid
integer (required) Example: 12

The ID of the diagram in the form of an integer

POST https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/diagrams/12/notes/
Requestsexample 1
Headers
Authorization: Token ABC123
Body
{
  "notes": "This is a updated note for the diagram"
}
Responses200
Headers
Content-Type: application/json
Body
{
  "id": "54",
  "notes": "This is a updated note for the diagram"
}

Update all Notes associated with a diagram
POST/projects/{projectid}/diagrams/{diagramid}/notes/

Returns the a JSON detailing the notes associated / linked to a diagram that is passed in the diagram ID parameter.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

diagramid
integer (required) Example: 12

The ID of the diagram in the form of an integer

Diagram Last Changed

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/diagrams/12/changeid/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "changehash": "57266cf8"
}

Get details last modified timestamp of a diagram
GET/projects/{projectid}/diagrams/{diagramid}/changeid/

Returns the a hash of the last modified date, can be used to see if a diagram has changed from the last time it was accessed.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

diagramid
integer (required) Example: 12

The ID of the diagram in the form of an integer

User Diagrams Selections

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/members/ufeusr1/diagrams/
Responses200
Headers
Content-Type: application/json
Body
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "areatype": "project",
        "color": "#da801c",
        "min_height": 0,
        "max_height": 45,
        "sysid": 26,
        "diagramid": 50,
        "sysname": "MIX",
        "author": "ufeusr1",
        "rgbcolor": "[218, 128, 28]",
        "description": "new housing"
      },
      "geometry": {
        "coordinates": [
          [
            [
              -6.253425,
              53.326606
            ],
            [
              -6.253683,
              53.326452
            ],
            [
              -6.253415,
              53.326372
            ],
            [
              -6.253184,
              53.326285
            ],
            [
              -6.253002,
              53.326292
            ],
            [
              -6.252868,
              53.32642
            ],
            [
              -6.253018,
              53.326516
            ],
            [
              -6.253195,
              53.3266
            ],
            [
              -6.253425,
              53.326606
            ]
          ]
        ],
        "type": "Polygon"
      }
    },
    {
      "type": "Feature",
      "properties": {
        "areatype": "project",
        "color": "#ffcc00",
        "min_height": 0,
        "max_height": 63,
        "sysid": 25,
        "diagramid": 95,
        "sysname": "LDH",
        "author": "ufeusr1",
        "rgbcolor": "[255, 204, 0]",
        "description": "test2"
      },
      "geometry": {
        "coordinates": [
          [
            [
              -6.255169,
              53.324732
            ],
            [
              -6.248817,
              53.325347
            ],
            [
              -6.251221,
              53.323553
            ],
            [
              -6.255169,
              53.324732
            ]
          ]
        ],
        "type": "Polygon"
      }
    }
  ]
}

Get details diagrams selected by a user
GET/projects/{projectid}/members/{username}/diagrams/

Returns the geometry of the diagrams selected by the user for the particular project. The user has to be a member of the project.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

username
string (required) Example: ufeusr1

The username of a user who is a member of the project

Thumbnails API

Resources related to images of diagrams within a project on Geodesignhub.

Generate All Diagrams Thumbnail

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/diagrams/all/generate_thumbnails/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
    "message": "Thumbnails Generated",
    "results_url": [
        "/api/v1/projects/b522ccca68f6decf/diagrams/138/thumbnail/d04c4c17-ff04-4354-8479-1de67b437523/",
        "/api/v1/projects/b522ccca68f6decf/diagrams/139/thumbnail/d04c4c17-ff04-4354-8479-1de67b437523/",
        "/api/v1/projects/b522ccca68f6decf/diagrams/140/thumbnail/d04c4c17-ff04-4354-8479-1de67b437523/",
        "/api/v1/projects/b522ccca68f6decf/diagrams/141/thumbnail/d04c4c17-ff04-4354-8479-1de67b437523/",
        "/api/v1/projects/b522ccca68f6decf/diagrams/142/thumbnail/d04c4c17-ff04-4354-8479-1de67b437523/",
    ]
}

Generate thumbnails of all diagrams in a project
GET/projects/{projectid}/diagrams/all/generate_thumbnails/

Returns a list of urls where you can download generated diagram thumbnails, useful for generating all diagram thumbnails in a project.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

Generate Diagram Thumbnail

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/diagrams/12/generate_thumbnail/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "message": "Task Generated",
  "results_url": "/api/v1/projects/5c84b38a16ebeed0/diagrams/12/thumbnail/70c5f4e6-b656-4412-8ee5-16c30de0509f"
}

Generate a thumbnail of a single diagram
GET/projects/{projectid}/diagrams/{diagramid}/generate_thumbnail/

Returns a uuid of the job that generates a thumbnail image, can be used to download a PNG image of a diagram.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

diagramid
integer (required) Example: 12

The ID of the diagram in the form of an integer

Get Diagram Thumbnail

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/diagrams/12/thumbnail/8f99a13f/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: image/png
Content-Length: 26572

Download a thumbnail of a diagram
GET/projects/{projectid}/diagrams/{diagramid}/thumbnail/{jobid}/

Returns a PNG image of the diagram thumbnail that was generated earlier, a PNG image is retured as a response

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

diagramid
integer (required) Example: 12

The ID of the diagram in the form of an integer

jobid
string (required) Example: 8f99a13f

04ae-48e3-8f51-40d967ec38ca (uuid) - The ID of the job as given by the earlier generate

Systems API

Resources related to systems within a project on Geodesignhub.

Systems Collection

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/systems/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
[
  {
    "id": 1,
    "sysname": "LDH",
    "syscolor": "#071ac8"
  },
  {
    "id": 2,
    "sysname": "HDH",
    "syscolor": "#fc1999"
  },
  {
    "id": 3,
    "sysname": "AG",
    "syscolor": "#18a81b"
  },
  {
    "id": 15,
    "sysname": "S4",
    "syscolor": "#0a650c"
  }
]

List project systems
GET/projects/{projectid}/systems/

Returns basic system details for the project with ID and system name. For futher details, look up the systems/{systemid} endpoint

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

System Detail

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/systems/23/
Responses200
Headers
Content-Type: application/json
Body
{
  "id": 1,
  "sysname": "LDH",
  "syscolor": "#071ac8",
  "systag": "SMB",
  "syscost": 100000,
  "sysbudget": 2000000
}

Get system details
GET/projects/{projectid}/systems/{sysid}/

Returns the details of that system such as system name, type, etc.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

sysid
integer (required) Example: 23

The ID of the system in the form of an integer

System Diagrams

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/systems/23/diagrams/
Responses200
Headers
Content-Type: application/json
Body
{
  "diagrams": [
    5,
    7,
    13,
    15,
    18
  ]
}

Get system diagrams
GET/projects/{projectid}/systems/{sysid}/diagrams/

Returns the IDs of all the diagrams contained in that system

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

sysid
integer (required) Example: 23

The ID of the system in the form of an integer

System Evaluation

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/systems/23/evaluation/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "geojson": {
    "type": "FeatureCollection",
    "features": [
      {
        "geometry": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -0.21629333496093747,
                51.5399294146093
              ],
              [
                -0.208740234375,
                51.53480425870272
              ],
              [
                -0.204620361328125,
                51.524979430024345
              ],
              [
                -0.204620361328125,
                51.514725174257
              ],
              [
                -0.2066802978515625,
                51.505750806437874
              ],
              [
                -0.218353271484375,
                51.497202145853784
              ],
              [
                -0.230712890625,
                51.49164465653034
              ],
              [
                -0.24307250976562497,
                51.48822432632349
              ],
              [
                -0.2767181396484375,
                51.48822432632349
              ],
              [
                -0.2877044677734375,
                51.49078959803455
              ],
              [
                -0.292510986328125,
                51.494637234974235
              ],
              [
                -0.2931976318359375,
                51.5091698216777
              ],
              [
                -0.2849578857421875,
                51.5283970022217
              ],
              [
                -0.276031494140625,
                51.536512708129735
              ],
              [
                -0.2684783935546875,
                51.540783551151826
              ],
              [
                -0.22384643554687497,
                51.54206472590799
              ],
              [
                -0.21629333496093747,
                51.5399294146093
              ],
              [
                -0.21629333496093747,
                51.5399294146093
              ]
            ]
          ]
        },
        "type": "Feature",
        "properties": {
          "areatype": "red",
          "color": "#f03b20"
        }
      },
      {
        "geometry": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -0.141448974609375,
                51.5403564848844
              ],
              [
                -0.13458251953125,
                51.53864817973767
              ],
              [
                -0.12153625488281249,
                51.52882418070984
              ],
              [
                -0.11947631835937499,
                51.52198884392169
              ],
              [
                -0.11947631835937499,
                51.50959718054336
              ],
              [
                -0.12359619140625,
                51.50062180251775
              ],
              [
                -0.1297760009765625,
                51.49634719159713
              ],
              [
                -0.1593017578125,
                51.497202145853784
              ],
              [
                -0.16754150390625,
                51.49848454717058
              ],
              [
                -0.1737213134765625,
                51.5027589576403
              ],
              [
                -0.1764678955078125,
                51.51045188624856
              ],
              [
                -0.17578125,
                51.519425328081894
              ],
              [
                -0.1627349853515625,
                51.53523137707124
              ],
              [
                -0.1544952392578125,
                51.5399294146093
              ],
              [
                -0.1483154296875,
                51.540783551151826
              ],
              [
                -0.141448974609375,
                51.5403564848844
              ],
              [
                -0.141448974609375,
                51.5403564848844
              ]
            ]
          ]
        },
        "type": "Feature",
        "properties": {
          "areatype": "green",
          "color": "#74c476"
        }
      },
      {
        "geometry": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -0.05699157714843749,
                51.56341232867588
              ],
              [
                -0.050811767578125,
                51.55999738544502
              ],
              [
                -0.0439453125,
                51.55231282551346
              ],
              [
                -0.03776550292968749,
                51.53523137707124
              ],
              [
                -0.0384521484375,
                51.5283970022217
              ],
              [
                -0.04119873046875,
                51.524552215462975
              ],
              [
                -0.0446319580078125,
                51.52198884392169
              ],
              [
                -0.0501251220703125,
                51.520707104039275
              ],
              [
                -0.05699157714843749,
                51.520707104039275
              ],
              [
                -0.06797790527343749,
                51.524124996893335
              ],
              [
                -0.06866455078125,
                51.53523137707124
              ],
              [
                -0.06591796875,
                51.54121061341155
              ],
              [
                -0.07415771484375,
                51.55487448974971
              ],
              [
                -0.06797790527343749,
                51.56255861691012
              ],
              [
                -0.0624847412109375,
                51.56426602441386
              ],
              [
                -0.05699157714843749,
                51.56341232867588
              ],
              [
                -0.05699157714843749,
                51.56341232867588
              ]
            ]
          ]
        },
        "type": "Feature",
        "properties": {
          "areatype": "green",
          "color": "#74c476"
        }
      }
    ]
  },
  "sysid": 1
}

Get system evaluation
GET/projects/{projectid}/systems/{sysid}/evaluation/

Returns a GeoJSON feature collection for the evaluation map for this system.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

sysid
integer (required) Example: 23

The ID of the system in the form of an integer

Add Project Diagram to System

POST https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/systems/23/add/project/
Requestsexample 1

A diagram must contain the following details

  • geometry A GeoJSON FeatureCollection object

  • featuretype Whether the diagram is a line or a polygon

  • description Title of the diagram

  • fundingtype Specify the funding type of the diagram:

    • pu - Public
    • pp - Public + Private
    • pr - Private
    • bu - Budgeted
Headers
Content-Type: application/json
Authorization: Token ABC123
Body
{
  "geometry": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "properties": {},
        "geometry": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -0.09307265281677245,
                51.516194024429446
              ],
              [
                -0.09310483932495117,
                51.51524595382876
              ],
              [
                -0.09136676788330077,
                51.51502562473659
              ],
              [
                -0.09100198745727538,
                51.515639872882986
              ],
              [
                -0.09152770042419434,
                51.51636093622468
              ],
              [
                -0.09307265281677245,
                51.51622740683744
              ],
              [
                -0.09307265281677245,
                51.516194024429446
              ]
            ]
          ]
        }
      }
    ]
  },
  "featuretype": "polygon",
  "description": "A new shopping mall",
  "fundingtype": "pu"
}
Responses200
Headers
Content-Type: application/json
Body
{
  "diagram_id": "2321",
  "grid_location": "TRANS 1",
  "status": "Successfully added diagram to the project"
}

Add a project diagram
POST/projects/{projectid}/systems/{sysid}/add/project/

Add a new diagram to a system

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

sysid
integer (required) Example: 23

The ID of the system in the form of an integer

Add Policy Diagram to System

POST https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/systems/23/add/policy/
Requestsexample 1

A diagram must contain the following details

  • geometry A GeoJSON FeatureCollection object

  • featuretype Whether the diagram is a line or a polygon

  • description Title of the diagram

  • fundingtype Specify the funding type of the diagram:

    • pu - Public
    • pp - Public + Private
    • pr - Private
    • bu - Budgeted
Headers
Content-Type: application/json
Authorization: Token ABC123
Body
{
  "geometry": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "properties": {},
        "geometry": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -0.10273933410644531,
                51.5111730317151
              ],
              [
                -0.10273933410644531,
                51.523003529077705
              ],
              [
                -0.08351325988769531,
                51.523003529077705
              ],
              [
                -0.08351325988769531,
                51.5111730317151
              ],
              [
                -0.10273933410644531,
                51.5111730317151
              ]
            ]
          ]
        }
      }
    ]
  },
  "featuretype": "polygon",
  "description": "Low taxation policy",
  "fundingtype": "pu"
}
Responses200
Headers
Content-Type: application/json
Body
{
  "diagram_id": "2042",
  "grid_location": "TRANS 1",
  "status": "Successfully added diagram to the project"
}

Add a policy diagram
POST/projects/{projectid}/systems/{sysid}/add/policy/

Add a new diagram to a system

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a policy in the form of an string

sysid
integer (required) Example: 23

The ID of the system in the form of an integer

Add Evaluation Map to a System

POST https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/systems/23/e/map/json/ufeusr1/
Requestsexample 1
Headers
Content-Type: application/json
Authorization: Token ABC123
Body
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "areatype": "red"
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -0.09307265281677245,
              51.516194024429446
            ],
            [
              -0.09310483932495117,
              51.51524595382876
            ],
            [
              -0.09136676788330077,
              51.51502562473659
            ],
            [
              -0.09100198745727538,
              51.515639872882986
            ],
            [
              -0.09152770042419434,
              51.51636093622468
            ],
            [
              -0.09307265281677245,
              51.51622740683744
            ],
            [
              -0.09307265281677245,
              51.516194024429446
            ]
          ]
        ]
      }
    }
  ]
}
Responses200
Headers
Content-Type: application/json
Body
{
    "msg":"Data successfully posted to users."}
}

Add evaluation map for a user
POST/projects/{projectid}/systems/{sysid}/e/map/json/{username}/

A geoJSON object that has the updated JSON layer of either evaluation or impact data submitted to the user

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

sysid
integer (required) Example: 23

The ID of the system in the form of an integer

username
string (required) Example: ufeusr1

The username of a user who is a member of the project

Add Impact Map to a System

POST https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/systems/23/i/map/json/ufeusr1/
Requestsexample 1
Headers
Content-Type: application/json
Authorization: Token ABC123
Body
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "areatype": "purple2"
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -0.09307265281677245,
              51.516194024429446
            ],
            [
              -0.09310483932495117,
              51.51524595382876
            ],
            [
              -0.09136676788330077,
              51.51502562473659
            ],
            [
              -0.09100198745727538,
              51.515639872882986
            ],
            [
              -0.09152770042419434,
              51.51636093622468
            ],
            [
              -0.09307265281677245,
              51.51622740683744
            ],
            [
              -0.09307265281677245,
              51.516194024429446
            ]
          ]
        ]
      }
    }
  ]
}
Responses200
Headers
Content-Type: application/json
Body
{
    "msg":"Data successfully posted to users."}
}

Add a impact map for a user
POST/projects/{projectid}/systems/{sysid}/i/map/json/{username}/

A geoJSON object that has the updated JSON layer of either evaluation or impact data submitted to the user

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

sysid
integer (required) Example: 23

The ID of the system in the form of an integer

username
string (required) Example: ufeusr1

The username of a user who is a member of the project

User System Diagram Selection

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/systems/23/ufeusr1/diagrams/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "type": "FeatureCollection",
  "features": [
    {
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -0.1064300537109375,
              51.5212411667077
            ],
            [
              -0.07432937622070312,
              51.50927666176991
            ],
            [
              -0.06299972534179688,
              51.505537109466715
            ],
            [
              -0.06282806396484375,
              51.50468231156
            ],
            [
              -0.06420135498046875,
              51.504148054725356
            ],
            [
              -0.07656097412109375,
              51.50607135001545
            ],
            [
              -0.08737564086914062,
              51.5089561407416
            ],
            [
              -0.09990692138671875,
              51.51066556016948
            ],
            [
              -0.1078033447265625,
              51.51087923308819
            ],
            [
              -0.10951995849609375,
              51.51525930707282
            ],
            [
              -0.11484146118164062,
              51.522522891558964
            ],
            [
              -0.11243820190429688,
              51.522629700334875
            ],
            [
              -0.1064300537109375,
              51.5212411667077
            ],
            [
              -0.1064300537109375,
              51.5212411667077
            ]
          ]
        ]
      },
      "type": "Feature",
      "properties": {
        "areatype": "policy",
        "color": "#071ac8",
        "systag": "Small buildings, low density housing"
      }
    },
    {
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -0.09514331817626952,
              51.51555307745177
            ],
            [
              -0.09394168853759766,
              51.51523260058079
            ],
            [
              -0.08668899536132812,
              51.51549966479653
            ],
            [
              -0.0856161117553711,
              51.515659902574384
            ],
            [
              -0.08085250854492186,
              51.51547295844541
            ],
            [
              -0.08020877838134766,
              51.51531272000991
            ],
            [
              -0.07797718048095703,
              51.51437798456801
            ],
            [
              -0.07746219635009766,
              51.51395067054886
            ],
            [
              -0.07741928100585936,
              51.51352335252112
            ],
            [
              -0.07784843444824219,
              51.5129891993494
            ],
            [
              -0.07973670959472656,
              51.51280224425956
            ],
            [
              -0.0832986831665039,
              51.51309603048481
            ],
            [
              -0.08703231811523438,
              51.51309603048481
            ],
            [
              -0.08870601654052734,
              51.5129891993494
            ],
            [
              -0.09029388427734374,
              51.51325627671818
            ],
            [
              -0.09162425994873047,
              51.51365688983539
            ],
            [
              -0.0960874557495117,
              51.51456493319091
            ],
            [
              -0.09724617004394531,
              51.514992241447835
            ],
            [
              -0.0972890853881836,
              51.51568660881589
            ],
            [
              -0.09552955627441406,
              51.51571331504175
            ],
            [
              -0.09514331817626952,
              51.51555307745177
            ],
            [
              -0.09514331817626952,
              51.51555307745177
            ]
          ]
        ]
      },
      "type": "Feature",
      "properties": {
        "areatype": "project",
        "color": "#071ac8",
        "systag": "Small buildings, low density housing"
      }
    }
  ]
}

Get diagrams selected in a system by user
GET/projects/{projectid}/systems/{sysid}/{username}/diagrams/

Returns the geometry of the diagrams selected by the user for the particular project and a specific system.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

sysid
integer (required) Example: 23

The ID of the system in the form of an integer

username
string (required) Example: ufeusr1

The username of a user who is a member of the project

User System Projects Diagram Selection

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/systems/23/ufeusr1/diagrams/projects/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "type": "FeatureCollection",
  "features": [
    {
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -0.09514331817626952,
              51.51555307745177
            ],
            [
              -0.09394168853759766,
              51.51523260058079
            ],
            [
              -0.08668899536132812,
              51.51549966479653
            ],
            [
              -0.0856161117553711,
              51.515659902574384
            ],
            [
              -0.08085250854492186,
              51.51547295844541
            ],
            [
              -0.08020877838134766,
              51.51531272000991
            ],
            [
              -0.07797718048095703,
              51.51437798456801
            ],
            [
              -0.07746219635009766,
              51.51395067054886
            ],
            [
              -0.07741928100585936,
              51.51352335252112
            ],
            [
              -0.07784843444824219,
              51.5129891993494
            ],
            [
              -0.07973670959472656,
              51.51280224425956
            ],
            [
              -0.0832986831665039,
              51.51309603048481
            ],
            [
              -0.08703231811523438,
              51.51309603048481
            ],
            [
              -0.08870601654052734,
              51.5129891993494
            ],
            [
              -0.09029388427734374,
              51.51325627671818
            ],
            [
              -0.09162425994873047,
              51.51365688983539
            ],
            [
              -0.0960874557495117,
              51.51456493319091
            ],
            [
              -0.09724617004394531,
              51.514992241447835
            ],
            [
              -0.0972890853881836,
              51.51568660881589
            ],
            [
              -0.09552955627441406,
              51.51571331504175
            ],
            [
              -0.09514331817626952,
              51.51555307745177
            ],
            [
              -0.09514331817626952,
              51.51555307745177
            ]
          ]
        ]
      },
      "type": "Feature",
      "properties": {
        "areatype": "project",
        "color": "#071ac8",
        "systag": "Small buildings, low density housing"
      }
    }
  ]
}

Get project diagrams selected in a system by user
GET/projects/{projectid}/systems/{sysid}/{username}/diagrams/projects/

Returns the geometry only of project diagrams selected by the user for the particular project and a specific system.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

sysid
integer (required) Example: 23

The ID of the system in the form of an integer

username
string (required) Example: ufeusr1

The username of a user who is a member of the project

User System Policies Diagram Selection

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/systems/23/ufeusr1/diagrams/policies/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "type": "FeatureCollection",
  "features": [
    {
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -0.1064300537109375,
              51.5212411667077
            ],
            [
              -0.07432937622070312,
              51.50927666176991
            ],
            [
              -0.06299972534179688,
              51.505537109466715
            ],
            [
              -0.06282806396484375,
              51.50468231156
            ],
            [
              -0.06420135498046875,
              51.504148054725356
            ],
            [
              -0.07656097412109375,
              51.50607135001545
            ],
            [
              -0.08737564086914062,
              51.5089561407416
            ],
            [
              -0.09990692138671875,
              51.51066556016948
            ],
            [
              -0.1078033447265625,
              51.51087923308819
            ],
            [
              -0.10951995849609375,
              51.51525930707282
            ],
            [
              -0.11484146118164062,
              51.522522891558964
            ],
            [
              -0.11243820190429688,
              51.522629700334875
            ],
            [
              -0.1064300537109375,
              51.5212411667077
            ],
            [
              -0.1064300537109375,
              51.5212411667077
            ]
          ]
        ]
      },
      "type": "Feature",
      "properties": {
        "areatype": "policy",
        "color": "#071ac8",
        "systag": "Small buildings, low density housing"
      }
    }
  ]
}

Get geometries of policy diagrams selected in a system by user
GET/projects/{projectid}/systems/{sysid}/{username}/diagrams/policies/

Returns the geometry only of policy diagrams selected by the user for the particular project and a specific system.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

sysid
integer (required) Example: 23

The ID of the system in the form of an integer

username
string (required) Example: ufeusr1

The username of a user who is a member of the project

Change Teams API

A set of resources related to Change teams within a Geodesignhub Project

Change Team Collection

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/cteams/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
[
  {
    "id": 1,
    "title": "DEV"
  },
  {
    "id": 4,
    "title": "ECON"
  }
]

List all change teams
GET/projects/{projectid}/cteams/

Return all the change teams for that project.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

Change Team Detail

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/cteams/12/
Responses200
Headers
Content-Type: application/json
Body
{
  "synthesis": [
    {
      "cteamid": 1,
      "creationdate": "2016-04-28T22:24:21.968000",
      "id": "PHBN4B9H1KDBHKPK",
      "description": "v3"
    },
    {
      "cteamid": 1,
      "creationdate": "2016-04-30T13:36:54.304000",
      "id": "9F79977KO8KB35GM",
      "description": "ve3"
    },
    {
      "cteamid": 1,
      "creationdate": "2016-04-30T13:39:01.860000",
      "id": "0FN94DJH903ONLH4",
      "description": "e2"
    },
    {
      "cteamid": 1,
      "creationdate": "2016-05-01T19:34:27.744000",
      "id": "7N1LP9E4E2OG81L8",
      "description": "new d"
    },
    {
      "cteamid": 1,
      "creationdate": "2016-05-01T19:36:05.462000",
      "id": "BE52E36N507DIBFF",
      "description": "old design"
    },
    {
      "cteamid": 1,
      "creationdate": "2016-05-01T19:36:33.845000",
      "id": "82F3ADJ2P67FCI8O",
      "description": "v5"
    },
    {
      "cteamid": 1,
      "creationdate": "2016-05-01T19:40:15.976000",
      "id": "9P45D3EA03ON7AL9",
      "description": "v09"
    },
    {
      "cteamid": 1,
      "creationdate": "2016-06-09T20:50:11.149083",
      "id": "EMHK5NP4K47OMHCB",
      "description": "v1"
    }
  ]
}

List designs of a change team
GET/projects/{projectid}/cteams/{cteamid}/

Returns a list of synthesis created by this change team

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

cteamid
integer (required) Example: 12

The ID of the change team in the form of an integer

Change Team Members

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/cteams/12/members/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "members": [
    "ufeusr1"
  ]
}

List members of a change team
GET/projects/{projectid}/cteams/{cteamid}/members/

Returns a list of usernames of users who are members of this change team.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

cteamid
integer (required) Example: 12

The ID of the change team in the form of an integer

Change Team Priorities

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/cteams/12/priorities/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "priorities": [
    {
      "sysid": "1",
      "pref": "10",
      "rank": 1
    },
    {
      "sysid": "2",
      "pref": "6",
      "rank": 2
    }
  ]
}

List change team priorities
GET/projects/{projectid}/cteams/{cteamid}/priorities/

Returns a object that details the system priorities and rank for this change team.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

cteamid
integer (required) Example: 12

The ID of the change team in the form of an integer

Design Synthesis ESRI JSON

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/cteams/12/2G638FLMLJEGF706/esri/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
[
  {
    "geometry": {
      "rings": [
        [
          [
            -6.255692,
            53.326477
          ],
          [
            -6.255649,
            53.326358
          ],
          [
            -6.255928,
            53.326262
          ],
          [
            -6.256051,
            53.326352
          ],
          [
            -6.255692,
            53.326477
          ]
        ]
      ],
      "spatialReference": {
        "wkid": 3857
      }
    },
    "attributes": {
      "id": 0
    }
  },
  {
    "geometry": {
      "rings": [
        [
          [
            -6.255418,
            53.326198
          ],
          [
            -6.255252,
            53.326102
          ],
          [
            -6.255585,
            53.32598
          ],
          [
            -6.255708,
            53.326105
          ],
          [
            -6.255418,
            53.326198
          ]
        ]
      ],
      "spatialReference": {
        "wkid": 3857
      }
    },
    "attributes": {
      "id": 0
    }
  },
  {
    "geometry": {
      "rings": [
        [
          [
            -6.255502,
            53.325996
          ],
          [
            -6.254879,
            53.326253
          ],
          [
            -6.254724,
            53.32609
          ],
          [
            -6.255437,
            53.325779
          ],
          [
            -6.255502,
            53.325996
          ]
        ]
      ],
      "spatialReference": {
        "wkid": 3857
      }
    },
    "attributes": {
      "description": "new polygon",
      "author": "ufeusr1",
      "diagramid": 31,
      "systag": "Small buildings, low density housing",
      "sysname": "LDH",
      "areatype": "project",
      "diagramtype": "project",
      "fundingtype": "public",
      "cost_override": 0,
      "cost_override_type": "per hectare.",
      "color": "#ffcc00",
      "notes": "",
      "min_height": 0,
      "additional_metadata": {},
      "max_height": 0,
      "tag_codes": "3.2|4.3|5.5",
      "start_date": "2020-02-26",
      "end_date": "2022-02-22"
    }
  },
  {
    "geometry": {
      "paths": [
        [
          [
            -6.254616,
            53.327141
          ],
          [
            -6.254128,
            53.327073
          ],
          [
            -6.253458,
            53.326977
          ],
          [
            -6.253479,
            53.326756
          ],
          [
            -6.253388,
            53.326551
          ],
          [
            -6.253597,
            53.326493
          ],
          [
            -6.25445,
            53.32617
          ]
        ]
      ],
      "spatialReference": {
        "wkid": 3857
      }
    },
    "attributes": {
      "description": "AG Numeric",
      "author": "ufeusr1",
      "diagramid": 61,
      "systag": "Agriculture, Forestry",
      "sysname": "AG",
      "areatype": "project",
      "diagramtype": "project",
      "fundingtype": "public",
      "cost_override": 100,
      "cost_override_type": "total",
      "color": "#C2E699",
      "notes": "",
      "min_height": 0,
      "max_height": 0,
      "additional_metadata": {},
      "tag_codes": "3.2|4.3|5.5",
      "start_date": "2020-02-26",
      "end_date": "2022-02-22"
    }
  }
]

Get design synthesis (ESRI-JSON)
GET/projects/{projectid}/cteams/{cteamid}/{synthesisid}/esri/

Returns a ESRI-JSON featureset object of the synthesis that is saved.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

cteamid
integer (required) Example: 12

The ID of the change team in the form of an integer

synthesisid
string (required) Example: 2G638FLMLJEGF706

The ID of a synthesis in the form of a string

Design Synthesis GeoJSON

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/cteams/12/2G638FLMLJEGF706/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "properties": {
                "description": "new polygon",
                "author": "ufeusr1",
                "diagramid": 31,
                "systag": "Small buildings, low density housing",
                "sysname": "LDH",
                "areatype": "project",
                "diagramtype": "project",
                "fundingtype": "public",
                "cost_override": 0,
                "cost_override_type": "per hectare.",
                "color": "#ffcc00",
                "notes":"",
                "min_height": 0,
                "max_height": 0,
                "additional_metadata": {},
                "tag_codes": "3.2|4.3|5.5",
                "start_date": "2020-02-26",
                "end_date": "2022-02-22"
            },
            "geometry": {
                "coordinates": [
                    [
                        [
                            -6.264439,
                            53.332213
                        ],
                        [
                            -6.263838,
                            53.328984
                        ],
                        [
                            -6.251392,
                            53.327241
                        ],
                        [
                            -6.241865,
                            53.332354
                        ],
                        [
                            -6.256371,
                            53.338402
                        ],
                        [
                            -6.264439,
                            53.332213
                        ]
                    ]
                              ],
                "type": "Polygon"
            }
        },
        {
            "type": "Feature",
            "properties": {
                "description": "AG Numeric",
                "author": "ufeusr1",
                "diagramid": 61,
                "systag": "Agriculture, Forestry",
                "sysname": "AG",
                "areatype": "project",
                "diagramtype": "project",
                "fundingtype": "public",
                "cost_override": 100,
                "cost_override_type": "total",
                "color": "#C2E699",
                "notes":"",
                "min_height": 0,
                "max_height": 0,
                "additional_metadata": {},
                "tag_codes": "3.2|4.3|5.5"
                "start_date": "2020-02-26",
                "end_date": "2022-02-22"
            },
            "geometry": {
                "coordinates": [
                    [
                        [
                            -6.252637,
                            53.329628
                        ],
                        [
                            -6.261048,
                            53.331012
                        ],
                        [
                            -6.240878,
                            53.334241
                        ],
                        [
                            -6.252637,
                            53.329628
                        ]
                    ]
                ],
                "type": "Polygon"
            }
        }
    ]
}

Get design synthesis
GET/projects/{projectid}/cteams/{cteamid}/{synthesisid}/

Returns a GeoJSON feature collection object of the synthesis that is saved.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

cteamid
integer (required) Example: 12

The ID of the change team in the form of an integer

synthesisid
string (required) Example: 2G638FLMLJEGF706

The ID of a synthesis in the form of a string

Change Team Synthesis Timeline

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/cteams/12/2G638FLMLJEGF706/timeline/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "timeline": {
    "6": {
      "start": "2016-11-15",
      "end": "2017-11-15"
    },
    "7": {
      "start": "2021-11-15",
      "end": "2022-11-15"
    },
    "8": {
      "start": "2021-11-15",
      "end": "2022-11-15"
    },
    "14": {
      "start": "2016-11-15",
      "end": "2017-11-15"
    },
    "15": {
      "start": "2016-11-15",
      "end": "2017-11-15"
    },
    "66": {
      "start": "2021-09-30",
      "end": "2022-09-30"
    }
  }
}

Get start and end time of diagrams
GET/projects/{projectid}/cteams/{cteamid}/{synthesisid}/timeline/

Returns the start and end time of diagrams (if set) at the time of saving a design.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

cteamid
integer (required) Example: 12

The ID of the change team in the form of an integer

synthesisid
string (required) Example: 2G638FLMLJEGF706

The ID of a synthesis in the form of a string

Change Team Synthesis Diagrams

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/cteams/12/2G638FLMLJEGF706/diagrams/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "diagrams": [
    49,
    10,
    11,
    12,
    17,
    18
  ],
  "synthesisid": "2G638FLMLJEGF706"
}

List diagrams in a synthesis
GET/projects/{projectid}/cteams/{cteamid}/{synthesisid}/diagrams/

Returns a list of diagram IDs in the selected synthesis.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

cteamid
integer (required) Example: 12

The ID of the change team in the form of an integer

synthesisid
string (required) Example: 2G638FLMLJEGF706

The ID of a synthesis in the form of a string

Change Team Synthesis Policies

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/cteams/12/2G638FLMLJEGF706/policies/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application / json
Body
{
  "type": "FeatureCollection",
  "features": [
    {
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -0.09514331817626952,
              51.51555307745177
            ],
            [
              -0.09394168853759766,
              51.51523260058079
            ],
            [
              -0.08668899536132812,
              51.51549966479653
            ],
            [
              -0.0856161117553711,
              51.515659902574384
            ],
            [
              -0.08085250854492186,
              51.51547295844541
            ],
            [
              -0.08020877838134766,
              51.51531272000991
            ],
            [
              -0.07797718048095703,
              51.51437798456801
            ],
            [
              -0.07746219635009766,
              51.51395067054886
            ],
            [
              -0.07741928100585936,
              51.51352335252112
            ],
            [
              -0.07784843444824219,
              51.5129891993494
            ],
            [
              -0.07973670959472656,
              51.51280224425956
            ],
            [
              -0.0832986831665039,
              51.51309603048481
            ],
            [
              -0.08703231811523438,
              51.51309603048481
            ],
            [
              -0.08870601654052734,
              51.5129891993494
            ],
            [
              -0.09029388427734374,
              51.51325627671818
            ],
            [
              -0.09162425994873047,
              51.51365688983539
            ],
            [
              -0.0960874557495117,
              51.51456493319091
            ],
            [
              -0.09724617004394531,
              51.514992241447835
            ],
            [
              -0.0972890853881836,
              51.51568660881589
            ],
            [
              -0.09552955627441406,
              51.51571331504175
            ],
            [
              -0.09514331817626952,
              51.51555307745177
            ],
            [
              -0.09514331817626952,
              51.51555307745177
            ]
          ]
        ]
      },
      "type": "Feature",
      "properties": {
        "areatype": "project",
        "diagramtype": "project",
        "fundingtype": "other",
        "author": "ufeusr1",
        "color": "#071ac8",
        "notes": "",
        "diagramid": 5,
        "description": "testing",
        "systag": "Small buildings, low density housing",
        "cost_override": 0,
        "cost_override_type": "per hectare.",
        "min_height": 0,
        "max_height": 0,
        "tag_codes": "3.2|4.3|5.5",
        "additional_metadata": {},
        "start_date": "2020-02-26",
        "end_date": "2022-02-22"
      }
    }
  ]
}

Get policy diagrams from design
GET/projects/{projectid}/cteams/{cteamid}/{synthesisid}/policies/

Returns a GeoJSON feature collection object of the all the policy diagrams in the synthesis that is saved.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

cteamid
integer (required) Example: 12

The ID of the change team in the form of an integer

synthesisid
string (required) Example: 2G638FLMLJEGF706

The ID of a synthesis in the form of a string

Change Team Synthesis Projects by System

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/cteams/12/2G638FLMLJEGF706/systems/23/projects/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application / json
Body
{
  "type": "FeatureCollection",
  "features": [
    {
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -0.13423919677734375,
              51.51536613288439
            ],
            [
              -0.1297760009765625,
              51.51344322994464
            ],
            [
              -0.12805938720703125,
              51.50981085847292
            ],
            [
              -0.12874603271484375,
              51.5091698216777
            ],
            [
              -0.13286590576171875,
              51.5091698216777
            ],
            [
              -0.14247894287109375,
              51.51173391474148
            ],
            [
              -0.14385223388671875,
              51.514084206610455
            ],
            [
              -0.14934539794921875,
              51.51792987720294
            ],
            [
              -0.13767242431640625,
              51.519425328081894
            ],
            [
              -0.13423919677734375,
              51.51536613288439
            ],
            [
              -0.13423919677734375,
              51.51536613288439
            ]
          ]
        ]
      },
      "type": "Feature",
      "properties": {
        "areatype": "project",
        "diagramtype": "project",
        "fundingtype": "other",
        "author": "ufeusr1",
        "color": "#331196",
        "diagramid": 10,
        "description": "ce3",
        "systag": "Small buildings, low density housing",
        "cost_override": 100,
        "notes": "",
        "cost_override_type": "total",
        "min_height": 0,
        "max_height": 0,
        "tag_codes": "3.2|4.3|5.5",
        "additional_metadata": {},
        "start_date": "2020-02-26",
        "end_date": "2022-02-22"
      }
    }
  ]
}

Get project diagrams filtered by system from design
GET/projects/{projectid}/cteams/{cteamid}/{synthesisid}/systems/{sysid}/projects/

Returns a GeoJSON feature collection object of of the all the project diagrams for the given system in the saved synthesis.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

cteamid
integer (required) Example: 12

The ID of the change team in the form of an integer

synthesisid
string (required) Example: 2G638FLMLJEGF706

The ID of a synthesis in the form of a string

sysid
integer (required) Example: 23

The ID of the system in the form of an integer

Change Team Synthesis Projects by System

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/cteams/12/2G638FLMLJEGF706/systems/23/policies/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application / json
Body
{
  "type": "FeatureCollection",
  "features": [
    {
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -0.14316558837890625,
              51.53523137707124
            ],
            [
              -0.13561248779296875,
              51.53266860674158
            ],
            [
              -0.13080596923828125,
              51.53010569212588
            ],
            [
              -0.127716064453125,
              51.525833847122584
            ],
            [
              -0.13080596923828125,
              51.52198884392169
            ],
            [
              -0.1366424560546875,
              51.52177522311313
            ],
            [
              -0.14316558837890625,
              51.52412499689336
            ],
            [
              -0.14453887939453125,
              51.52796981972546
            ],
            [
              -0.14247894287109375,
              51.531600743186644
            ],
            [
              -0.1531219482421875,
              51.53693981046692
            ],
            [
              -0.14316558837890625,
              51.53523137707124
            ],
            [
              -0.14316558837890625,
              51.53523137707124
            ]
          ]
        ]
      },
      "type": "Feature",
      "properties": {
        "areatype": "policy",
        "diagramtype": "policy",
        "author": "ufeusr1",
        "fundingtype": "other",
        "color": "#331196",
        "diagramid": 12,
        "description": "656",
        "systag": "Small buildings, low density housing",
        "cost_override": 0,
        "cost_override_type": "total",
        "notes": "",
        "min_height": 0,
        "max_height": 0,
        "additional_metadata": {},
        "tag_codes": "3.2|4.3|5.5",
        "start_date": "2020-02-26",
        "end_date": "2022-02-22"
      }
    }
  ]
}

Get policy diagrams filtered by system from design
GET/projects/{projectid}/cteams/{cteamid}/{synthesisid}/systems/{sysid}/policies/

Returns a GeoJSON feature collection object of of the all the policy diagrams for the given system in the saved synthesis.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

cteamid
integer (required) Example: 12

The ID of the change team in the form of an integer

synthesisid
string (required) Example: 2G638FLMLJEGF706

The ID of a synthesis in the form of a string

sysid
integer (required) Example: 23

The ID of the system in the form of an integer

Actions API

A set of resources related to Actions within a Geodesignhub Project

Project Stakeholders

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/stakeholders/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "stakeholders": [
    {
      "id": "50e6964e-dcf8-4967-bbd2-b448679f1514"
      "name": "City Council"
    },
    {
      "id": "c204303b-d23a-4fa7-b4b2-6a4c51410c81",
      "name": "Department of Transport"
    },
    {
      "id": "50f13d08-a472-4477-88a3-5a14b294ca33",
      "name": "Private Company"
    }
  ]
}

List stakeholders of a project
GET/projects/{projectid}/stakeholders/

Returns a list of all the stakeholder that are added to the project.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

POST https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/stakeholders/
Requestsexample 1
Headers
Authorization: Token ABC123
Body
[
  "City Council",
  "Department of Transport"
]
Responses200
Headers
Content-Type: application/json
Body
{
  "message": "2 stakeholders created successfully and added to the project"
}

Add project stakeholder
POST/projects/{projectid}/stakeholders/

Add multiple stakeholders to the project

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

Boards Collection

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/boards/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
[
  {
    "id": "8f99a13f-04ae-48e3-8f51-40d967ec38ca",
    "synthesisid": "PCJ4JKX9MVSJGN6J",
    "description": "N.1"
  }
]

List all boards created for a project
GET/projects/{projectid}/boards/

Return all the boards for that project.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

Board Detail

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/boards/8f99a13f/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "id": "8f99a13f-04ae-48e3-8f51-40d967ec38ca",
  "updated": "2019-04-27T20:47:36.071973"
}

Get details of a board
GET/projects/{projectid}/boards/{boardid}/

Returns details the board that is passed in the boards ID.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

boardid
string (required) Example: 8f99a13f

04ae-48e3-8f51-40d967ec38ca (uuid) - The ID of the digaram in the form of an uuid4 string

Board timeline Detail

GET https://www.geodesignhub.com/api/v1/projects/5c84b38a16ebeed0/boards/8f99a13f/timeline/
Requestsexample 1
Headers
Authorization: Token ABC123
Responses200
Headers
Content-Type: application/json
Body
{
  "id": "8016e23a-70bc-48a9-9a05-5a8bb48bd16f",
  "timeline_data": [
    {
      "content": "TRANS 1 Add more Bars/Restaurants to the Amsterdamse Poort",
      "start": "2020-02-26T00:00:00.000Z",
      "end": "2022-02-22T00:00:00.000Z",
      "system_id": 46,
      "diagram_id": 139,
      "project_or_policy": "project"
    },
    {
      "content": "LDH 1 t3",
      "start": "2020-09-05T00:00:00.000Z",
      "end": "2022-09-02T00:00:00.000Z",
      "system_id": 48,
      "diagram_id": 138,
      "project_or_policy": "project"
    },
    {
      "content": "MIX 2 test",
      "start": "2020-02-01T00:00:00.000Z",
      "end": "2022-02-01T00:00:00.000Z",
      "system_id": 49,
      "diagram_id": 178,
      "project_or_policy": "project"
    },
    {
      "content": "PREC 2 test",
      "start": "2020-02-26T00:00:00.000Z",
      "end": "2022-02-22T00:00:00.000Z",
      "system_id": 50,
      "diagram_id": 160,
      "project_or_policy": "project"
    },
    {
      "content": "T2",
      "end": "2024-07-24T09:08:47.416251+00:00",
      "start": "2023-07-26T09:08:47.416150+00:00",
      "system_id": "Tasks",
      "diagram_id": "37d2bdd9-09e5-4eb3-a2d2-b6c87c5fe93d",
      "project_or_policy": "policy"
    }
  ]
}

Get details of the timeline in a board
GET/projects/{projectid}/boards/{boardid}/timeline/

Returns details the timeline that is associated with the passed board ID.

URI Parameters
HideShow
projectid
string (required) Example: 5c84b38a16ebeed0

The ID of a project in the form of an string

boardid
string (required) Example: 8f99a13f

04ae-48e3-8f51-40d967ec38ca (uuid) - The ID of the digaram in the form of an uuid4 string

Generated by Aglio on 14 Sep 2023