urbanriskmap / petabencana-docs

Petabencana API Documentation
0 stars 2 forks source link

Add information on /floods/archive endpoint #7

Open tomasholderness opened 6 years ago

tomasholderness commented 6 years ago

New endpoint needs documenting.

avicennavicenna commented 6 years ago

Hi @talltom, I used the API of /floods/archive to get the 7 days back for Jakarta's flood but seems there is some missing info regarding the area_id and its reference (as I need to get the flood data with its area name (Kelurahan)). Could you enlighten me to map the area_id to Kelurahan name or maybe share the reference of map_id to Kelurahan? Any response will be appreciated. Thanks!

tomasholderness commented 6 years ago

Hi @avicennavicenna - thanks for the note. I will make a note to update the documentation. Currently, we don't tag reports with Kelurahan name. Perhaps check to see if HOT have that data, which could be used instead? https://openstreetmap.id/en/data-openstreetmap-indonesia/

avicennavicenna commented 6 years ago

Hi @talltom, thanks for your response. Then, how the /floods/archive gives the area_id value? Is it from the open street map or cognicity-server? I am not sure if I understood you but If I look at the .pbf file of open street map of Jakarta, I think it should be in other_tags named "is_in_village". Area_id or localAreaId is not found on the OSM though. Sorry, if I misunderstood your statement and Thanks!

tomasholderness commented 6 years ago

Hi @avicennavicenna - the area_id is an internally generated number (created by our database) based on the area that the report is inside. Currently, we only use this number internally to organise reports for display, and because it is dynamically generated by the database it can not be used outside the database to identify Kelurahan etc.