Library of example catalog items (for documentation/getting started purposes)

[nf-s]

I think we need a nice library of example catalog items - the easiest way for someone new to Terria to create a map is by copying and then slightly modifying examples (I guess this goes for anything right?)

So I am putting all of my github gists here for reference until we get a Wiki or something going.

These examples should appear in docs.terria.io under each Catalog Item/Group/Reference:

• Include the JSON snippet inline with docs
• Include a link using map.terria.io to show the example

We also need to include a short description of each Catalog Item/Group/Reference

The list of examples doesn't need to be fully complete (eg show examples of all traits)

Note

Suggest to create a public S3 bucket folder that contains all files, such as csv and czml files, to be used in the examples.

I've created this folder for the purpose.

• ApiTableCatalogItem (api-table)
• ArcGisCatalogGroup (esri-group)
• ArcGisFeatureServerCatalogGroup (esri-featureServer-group)
• ArcGisFeatureServerCatalogItem (esri-featureServer)
• ArcGisMapServerCatalogGroup (esri-mapServer-group)
• ArcGisMapServerCatalogItem (esri-mapServer)
• ArcGisPortalCatalogGroup (arcgis-portal-group)
• ArcGisPortalItemReference (arcgis-portal-item)
• ArcGisTerrainCatalogItem
• AssImpCatalogItem
• BingMapsCatalogItem
• CartoMapV1CatalogItem
• CartoMapV3CatalogItem
• CatalogGroup
• CatalogIndexReference
• Cesium3DTilesCatalogItem (3d-tiles)
• CesiumTerrainCatalogItem (cesium-terrain)
• CkanCatalogGroup (ckan-group)
• CkanItemReference (ckan-item)
• CompositeCatalogItem (composite)
• CsvCatalogItem (csv)
• CswCatalogGroup (csw)
• CzmlCatalogItem (czml)
• GeoJsonCatalogItem (geojson)
• GeoRssCatalogItem (georss)
• GltfCatalogItem (gltf)
• GpxCatalogItem (gpx)
• GtfsCatalogItem (gtfs) Note: Need to find a public service url. This https://api.transport.nsw.gov.au/v1/gtfs/vehiclepos/buses needs credentials.
• IonImageryCatalogItem (ion-imagery)
• KmlCatalogItem (kml)
• MagdaReference (magda)
• MapboxMapCatalogItem (mapbox-map)
• MapboxStyleCatalogItem (mapbox-style)
• MapboxVectorTileCatalogItem (mvt)
• OpenDataSoftCatalogGroup (opendatasoft-group)
• OpenDataSoftCatalogItem (opendatasoft-item)
• OpenStreetMapCatalogItem (open-street-map)
• SdmxCatalogGroup (sdmx-group)
• SdmxJsonCatalogItem (sdmx-json)
• SenapsLocationsCatalogItem (senaps-locations)
• SensorObservationServiceCatalogItem (sos) Note: Need to find a public service url. This service http://www.bom.gov.au/waterdata/services is not free.
• ShapefileCatalogItem (shp)
• SocrataCatalogGroup (socrata-group)
• SocrataMapViewCatalogItem (socrata-map-item)
• SplitItemReference (split-reference)
• StubCatalogItem (stub)
• TerriaReference (terria-reference)
• ThreddsCatalogGroup (thredds-group)
• UrlReference (url-reference)
• UrlTemplateImageryCatalogItem (url-template-imagery)
• WebFeatureServiceCatalogItem (wfs)
• WebFeatureServiceCatalogGroup (wfs-group)
• WebMapServiceCatalogItem (wms)
• WebMapServiceCatalogGroup (wms-group)
• WebMapTileServiceCatalogItem (wmts)
• WebMapTileServiceCatalogGroup (wmts-group)
• WebProcessingServiceCatalogFunction (wps)
• WebProcessingServiceCatalogFunctionJob (wps-result)
• WebProcessingServiceCatalogGroup (wps-getCapabilities)
• YDYRCatalogFunction (ydyr)
• YDYRCatalogFunctionJob (ydyr-job)

[nf-s]

Thredds catalog group

https://gist.github.com/nf-s/6a002318d6ee2aac086c56e754b4e5ca

[nf-s]

Catalog functions - WPS and YDYR

https://gist.github.com/nf-s/36eabf17577e78a5cde482928d96ff52

[nf-s]

WMTS

https://gist.github.com/nf-s/075689074a843bcf99182241406d7858

[nf-s]

SDMX

https://gist.github.com/nf-s/24b9288c6cdb6ba41d12f3d269318a0d

[nf-s]

CKAN

https://gist.github.com/nf-s/715b0a35c94f3f48e2595eef28b48c3d

[nf-s]

WFS

https://gist.github.com/nf-s/b71d4aef0e027c8013136a3c6dc895dc

[nf-s]

WMS (shows styles and dimensions) + DiffWms

https://gist.github.com/nf-s/3d77d4acb9105283226444677e011dd9

WMS with WCS

https://gist.github.com/nf-s/8a55c04720ec60f5d210f794ad604599

[nf-s]

Polling CSV

https://gist.github.com/nf-s/7add30fc21d000e5e1710faf09e0dc4b

[nf-s]

GeoJSON with short report sections

https://gist.github.com/nf-s/be2c74551c426011914fedd6d3d8b20d

[nf-s]

We have some ability to add description and examples to trait classes

For example

terriajs/lib/Traits/TraitsClasses/WebMapServiceCatalogItemTraits.ts

Lines 157 to 167 in 8514256

	@traitClass({
	description: `Creates a single item in the catalog from one or many WMS layers.
	<strong>Note:</strong> <i>To present all layers in an available WMS as individual items in the catalog use the \`WebMapServiceCatalogGroup\`.</i>`,
	example: {
	type: "wms",
	name: "Mangrove Cover",
	url: "https://ows.services.dea.ga.gov.au",
	layers: "mangrove_cover_v2_0_2"
	}
	})