Extended Regions

Date	2012/09/14
Contact(s)	​Jesse Eichar
Last edited
Status	Proposed
Assigned to release	2.9.x
Resources	Jesse personal time
Code	​https://github.com/jesseeichar/core-geonetwork/tree/improvement/regions

Overview

This proposal intends to extend the existing Regions API with the following features:

• Add category for each region so they can be displayed in categories (for example continent, country, province)
• Add API for searching regions based:
  • name
  • category
  • bbox
• Add optional geometry for each region (in addition to bbox)
• integrate into XmlSearch and Csw so that the region id can be used to look up the geometry of the region for a spatial filter
• Add a configurable strategy object for that allows the region implementation to be easily pluggable. For example it might be based on a table in the database or wfs

Proposal Type

• Type: Improvement
• App: Geonetwork
• Module: Web

Links

• Email discussions:
• IRC discussions:
• Related work:

Voting History

• None as yet

---

Proposal

The Regions will be backwards compatible but will simply extend the functionality. Currently the Regions API provides a list of regions, each with a unique id. Each region has translated labels and a bounding box. The proposal will extend that API. The new API will be:

• Get
  • Params
    • id
  • Example Response:

    <response>
      <record>
        <id>338</id>
        <north>38.2</north>
        <south>-34.6</south>
        <west>-17.3</west>
        <east>51.1</east>
        <label>
          <eng>Africa</eng>
          <fre>Afrique</fre>
          <ger>Afrika</ger>
          <spa>Africa</spa>
          <rus>Africa</rus>
          <por>Africa</por>
          <chi>Africa</chi>
          <dut>Afrika</dut>
          <nor>Africa</nor>
          <fin>Africa</fin>
          <ara>Africa</ara>
          <ita>Africa</ita>
        </label>
        <category>continent</category>
        <hasGeom>false</hasGeom>
      </record>
    </response>
    

Backwards Compatibility Issues

none

Risks

Participants

• As above