Project settings

Project settings object is used to define project-specific features. It references only datasets. Also, apart from other metadata objects, there can be only one project settings object in a project.

Syntax

This is the project settings object of the Retail Solution Demo. This demo covers only a part of the Birmingham area, so we use the code for the Great Britain - GB.

Project settings object syntax

CODE

{
    "name": "project_settings_gb",
    "type": "projectSettings",
    "content": {
        "defaultViews": [
            "/rest/projects/$projectId/md/views?name=catchment_area_view",
            "/rest/projects/$projectId/md/views?name=restaurants_rating_view"
        ],
        "geoSearchCountries": [
            "GB"
        ],
        "geoSearchProviders": [
            "Mapbox"
        ]
    }
}

Example of a dumped project settings

CODE

{
    "url": "/rest/projects/kt3hz932v53vabh8/md/projectSettings/qr0kekodkijcuhev",
    "dumpTime": "2018-06-27T19:42:27Z",
    "version": "1",
    "content": {
        "id": "qr0kekodkijcuhev",
        "name": "project_settings_gb",
        "type": "projectSettings",
        "content": {
            "defaultViews": [
                "/rest/projects/$projectId/md/views?name=catchment_area_view",
                "/rest/projects/$projectId/md/views?name=restaurants_rating_view"
            ],
            "geoSearchCountries": [
                "GB"
            ],
            "geoSearchProviders": [
                "Mapbox"
            ]
        },
        "accessInfo": {
            "createdAt": "2018-06-27T11:26:07Z"
        },
        "links": [
            {
                "rel": "self",
                "href": "/rest/projects/kt3hz932v53vabh8/md/projectSettings/qr0kekodkijcuhev"
            }
        ]
    }
}

Additional syntax examples

Example of a projectSettings object with template

CODE

{
    "name": "project_settings_template",
    "type": "projectSettings",
    "content": {
        "geoSearchCountries": [
            "GB"
        ],
        "geoSearchProviders": [
            "Mapbox"
        ],
        "projectTemplate": {
            "templateDatasets": [
                {
                    "dataset": "/rest/projects/$projectId/md/datasets?name=baskets"
                }
            ]
        }
    }
}

This example has a projectTemplate object with settings related to project templates.

Example of a projectSettings object with trustedOrigins

CODE

{
    "name": "project_settings_template",
    "type": "projectSettings",
    "content": {
        "geoSearchCountries": [
            "GB"
        ],
        "geoSearchProviders": [
            "Mapbox"
        ],
        "trustedOrigins": [
            "http://stories.clevermaps.io",
            "https://www.stories.clevermaps.io:443"
        ]
    }
}

This example has a trustedOrigins array with URL whitelisted for iFrame postMessage API.

Example of a projectSettings object with defaultViews

CODE

{
    "name": "project_settings_template",
    "type": "projectSettings",
    "content": {
        "geoSearchCountries": [
            "GB"
        ],
        "geoSearchProviders": [
            "Mapbox"
        ],
        "defaultViews": [
            "/rest/projects/$projectId/md/views?name=catchment_area_view",
            "/rest/projects/$projectId/md/views?name=restaurants_rating_view"
        ]
    }
}

This example has a defaultViews array with URLs of views to be displayed in UI/dumped into project dump for all project members.

Key description

`content`

Key	Type	Optionality	Description	Constraints
`geoSearchCountries`	array	REQUIRED	array of ISO 3166 alpha-2 country codes, to which the geographic search will be limited	`(A-Z)`
`geoSearchProviders`	array	REQUIRED	list of geosearch providers default = `[Mapbox]`	`[Mapbox]`
`projectTemplate`	object	OPTIONAL	object containing settings related to project templates
`trustedOrigins`	array	OPTIONAL	list of whitelisted URL for iFrame postMessage API. Add a URL if you want to communicate with iFrame from your page.	`protocol://host.name.domain(:PORT)?`
`allowUnsecuredOrigins`	boolean	OPTIONAL	allows embedding of current project to any URL and communicate via postMessage API. Enabling this option could have a security impact, please consider security risk of this setting. Values in `trustedOrgins` are ignored once `allowUnsecuredOrigins` is set to `true`. default = `false`
`defaultViews`	array	OPTIONAL	list of views (URLs corresponding to views) to be displayed in UI/dumped into project dump for all project members An order of views in `defaultViews` array defines the order in which views are displayed in project page in UI. Views that are not listed in `defaultViews` (i.e. personal saved views) are visible only to creator and are displayed in alphabetical order at the end of view list in project page in UI. Personal saved views are marked in UI with an icon in the corner of view tile as follows:	`"^/rest/projects/(\\$projectId\|[a-z0-9]{16})/md/views(\\?name=[a-z0-9_-]+\|/[a-z0-9]+)$"`

`content.projectTemplate`

Key	Type	Optionality	Description	Constraints
`templateDatasets`	array	OPTIONAL	array of dataset links	`size => 1`

`content.projectTemplate.dataset`

Key	Type	Optionality	Description	Constraints
`dataset`	string	OPTIONAL	URL link to the dataset, which will be loadable with data during custom create project	`/rest/projects/$projectId/md/datasets?name={datasetName}`

Visual representation

Project settings do not have a visual representation in the application.