update openaerialmap example

Author: vincentsarago

demo/oam/README.md

@@ -1,89 +1,9 @@
+## Case of Study - Open Aeria Map (OAM)
 
-1. Get list of images
+https://map.openaerialmap.org
 
-```bash
-curl https://api.openaerialmap.org/meta\?limit\=1000\&page\=1 | jq '.results[]' -c > oam.njson
-curl https://api.openaerialmap.org/meta\?limit\=1000\&page\=2 | jq '.results[]' -c >> oam.njson
-curl https://api.openaerialmap.org/meta\?limit\=1000\&page\=3 | jq '.results[]' -c >> oam.njson
-curl https://api.openaerialmap.org/meta\?limit\=1000\&page\=4 | jq '.results[]' -c >> oam.njson
-curl https://api.openaerialmap.org/meta\?limit\=1000\&page\=5 | jq '.results[]' -c >> oam.njson
-curl https://api.openaerialmap.org/meta\?limit\=1000\&page\=6 | jq '.results[]' -c >> oam.njson
-curl https://api.openaerialmap.org/meta\?limit\=1000\&page\=7 | jq '.results[]' -c >> oam.njson
-curl https://api.openaerialmap.org/meta\?limit\=1000\&page\=8 | jq '.results[]' -c >> oam.njson
-curl https://api.openaerialmap.org/meta\?limit\=1000\&page\=9 | jq '.results[]' -c >> oam.njson
-curl https://api.openaerialmap.org/meta\?limit\=1000\&page\=10 | jq '.results[]' -c >> oam.njson
-curl https://api.openaerialmap.org/meta\?limit\=1000\&page\=11 | jq '.results[]' -c >> oam.njson
-```
+> OpenAerialMap (OAM) is a set of tools for searching, sharing, and using openly licensed satellite and unmanned aerial vehicle (UAV) imagery.
 
-2. Create items
+Believe it or not but OAM was created more than 9 years ago!!! The design was innovative and the backend was also in advance. It was one of the first application using dynamic tiling (https://github.com/mojodna/marblecutter-openaerialmap) and STAC like metadata (https://github.com/hotosm/oam-api).
 
-```python
-import pystac
-import json
-
-from pystac.utils import datetime_to_str, str_to_datetime
-
-
-with open("oam.njson", "r") as fin:
-    with open("oam_items.njson", "w") as fout:
-        for line in fin.readlines():
-            try:
-                itm = json.loads(line)
-                item = pystac.Item(
-                    id=itm["_id"],
-                    geometry=itm["geojson"],
-                    bbox=itm["bbox"],
-                    collection="openaerialmap",
-                    stac_extensions=[],
-                    datetime=None,
-                    properties={
-                        "title": itm["title"],
-                        "platform": itm["platform"],
-                        "provider": itm["provider"],
-                        "contact": itm["contact"],
-                        "start_datetime": datetime_to_str(str_to_datetime(itm['acquisition_start'])),
-                        "end_datetime": datetime_to_str(str_to_datetime(itm['acquisition_end'])),
-                    },
-                )
-
-                item.add_link(
-                    pystac.Link(
-                        pystac.RelType.COLLECTION,
-                        "openaerialmap",
-                        media_type=pystac.MediaType.JSON,
-                    )
-                )
-
-                item.add_asset(
-                    key="image",
-                    asset=pystac.Asset(href=itm["uuid"], media_type=pystac.MediaType.COG),
-                )
-                # Here we make sure to remove any invalid character
-                fout.write(json.dumps(item.to_dict(), ensure_ascii=False).encode("ascii", "ignore").decode("utf-8").replace('\\"', "") + "\n")
-            except:
-                continue
-```
-
-Note: You may want to remove really old imagery (e.g the one from 1949) to avoid creating partition for only one image.
-
-3. create oam_collection.json
-```json
-{"id": "openaerialmap", "title": "OpenAerialMap", "description": "OpenAerialMap Dataset", "stac_version": "1.0.0", "license": "public-domain", "links": [], "extent": {"spatial": {"bbox": [[-180, -90, 180, 90]]}, "temporal": {"interval": [["1944-12-31T13:00:00.000Z", "null"]]}}}
-```
-
-Note: the json must be in form of NewLine delimited (one item/collection per line).
-
-4. upload collection and items to the RDS postgres instance (using pypgstac)
-
-
-```bash
-$ pypgstac load collections oam_collection.json --dsn postgresql://{db-user}:{db-password}@{db-host}:{db-port}/{db-name} --method insert
-
-$ pypgstac load items oam_items.njson --dsn postgresql://{db-user}:{db-password}@{db-host}:{db-port}/{db-name} --method insert
-```
-
-
-Note:
-
-- You may have to add you address IP to the VPC inbounds rules to be able to connect to the RDS instance.
-- You can find the database info in your AWS Lambda configuration (host, user, password, post)
+Looking at the web page and backend today, it feels still great and better than a lot of similar projects.