odis-arch icon indicating copy to clipboard operation
odis-arch copied to clipboard

Pattern template needed for sharing ArcGIS REST API endpoints

Open jmckenna opened this issue 2 years ago • 3 comments

  • LAC team has been developing a harvesting script that extracts metadata from ArcGIS REST API endpoints (screen capture below) robot-example
  • 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

jmckenna avatar May 09 '23 19:05 jmckenna

@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?

pbuttigieg avatar May 18 '23 14:05 pbuttigieg

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 :

  • service: https://github.com/iodepo/odis-arch/blob/master/book/thematics/services/graphs/service.json
  • webapi: https://github.com/iodepo/odis-arch/blob/master/book/thematics/webapi/graphs/webapi.json

jmckenna avatar May 18 '23 14:05 jmckenna

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 .

pbuttigieg avatar Mar 26 '24 15:03 pbuttigieg