Pattern template needed for sharing ArcGIS REST API endpoints

jmckenna commented 1 year ago

LAC team has been developing a harvesting script that extracts metadata from ArcGIS REST API endpoints (screen capture below)

sample JSON from harvest:

[
    {
        "Url": "https://gis.invemar.org.co/arcgis/rest/services/SIGMA/AMP_SIGMA/MapServer?f=pjson",
        "Service Description": "Areas Protegidas asociadas a manglar en Colombia, a nivel nacional regional e internacional,  Incluye \u00e1reas del SPNN (Paques Nacionales Naturales, Santuarios de Fauna y Flora y V\u00eda Parque) de ord\u00e9n naciona, a nivel regional se incluyen (Distritos de manejo integrado y parques regionales) y a nivel internacional se incluyen las areas RAMSAR y de reserva de BIOSFERA.",
        "Copyright Text": "INVEMAR. 2014."
    },
    {
        "Url": "https://gis.invemar.org.co/arcgis/rest/services/SIGMA/BASE_CARTOG/MapServer?f=pjson",
        "Service Description": "Cartograf\u00eda base optimizada para el proyecto SIGMA, proyectada en el datum MAGNA geograficas, se organizo en 3 grandes grupos hidrologia, general y otras referencias.",
        "Copyright Text": "INVEMAR"
    },
    {
        "Url": "https://gis.invemar.org.co/arcgis/rest/services/SIGMA/BASE_CARTOGRAF/MapServer?f=pjson",
        "Service Description": "Cartograf\u00eda base optimizada para el proyecto SIGMA, proyectada en el datum MAGNA geograficas, se organizo en 3 grandes grupos hidrologia, general y otras referencias.",
      he  "Copyright Text": "INVEMAR"
    },
    {
        "Url": "https://gis.invemar.org.co/arcgis/rest/services/SIGMA/BIODIVERSIDAD/MapServer?f=pjson",
        "Service Description": "Sistemas ecol\u00f3logicos Asociados a Manglares y su fauna pueden ser indicativos del estado de un manglar espacializando la interacion y ubicacion de fauna ",
        "Copyright Text": "INVEMAR. 2014."
    },
    ...
]

need to provide a pattern template to the LAC team (do these remote services fit the dataset pattern template?? https://github.com/iodepo/odis-arch/blob/schema-dev/book/thematics/dataset/graphs/datasetTemplate.json )

cc @ZulayGonzalez

pbuttigieg commented 1 year ago

@jmckenna did we resolve this in https://github.com/iodepo/odis-arch/pull/225?

Or do you want it open until the book is updated?

jmckenna commented 1 year ago

I think we should leave this issue open until added into the book.

@ZulayGonzalez here are the new ODIS pattern templates, for Services and WebAPI :

pbuttigieg commented 4 months ago

Note to self - include links to official documentation pages in the documentation property of WebApi

in the absence of CVs for web service types that are stable, representative, and well governed globally, these links and the official titles and descriptions of APIs and other services the docs describe are the best discovery vector we have .

iodepo / odis-arch

Pattern template needed for sharing ArcGIS REST API endpoints #222