Duplicate from nt3awnou/Nt3awnou-rescue-map

Co-authored-by: Nouamane Tazi <nouamanetazi@users.noreply.huggingface.co>

.gitattributes

@@ -0,0 +1,35 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,23 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+
+# C extensions
+*.so
+
+# Distribution / packaging
+bin/
+build/
+develop-eggs/
+dist/
+eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# vscode
+.vscode

.streamlit/config.toml

@@ -0,0 +1,28 @@
+[browser]
+
+# Internet address where users should point their browsers in order to
+# connect to the app. Can be IP address or DNS name and path.
+
+# This is used to:
+# - Set the correct URL for CORS and XSRF protection purposes.
+# - Show the URL on the terminal
+# - Open the browser
+
+# Default: "localhost"
+serverAddress = "localhost"
+
+# Whether to send usage statistics to Streamlit.
+
+# Default: true
+gatherUsageStats = false
+
+# Port where users should point their browsers in order to connect to the
+# app.
+
+# This is used to:
+# - Set the correct URL for CORS and XSRF protection purposes.
+# - Show the URL on the terminal
+# - Open the browser
+
+# Default: whatever value is set in server.port.
+serverPort = 8502

README.md

@@ -0,0 +1,12 @@
+---
+title: Nt3awnu Map
+emoji: ❤️
+colorFrom: white
+colorTo: white
+sdk: streamlit
+sdk_version: 1.26.0
+app_file: app.py
+duplicated_from: nt3awnou/Nt3awnou-rescue-map
+---
+
+Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

app.py

@@ -0,0 +1,298 @@
+import os
+import time
+from datetime import datetime
+
+import folium
+import pandas as pd
+import streamlit as st
+from huggingface_hub import HfApi
+from streamlit_folium import st_folium
+from src.utils import add_latlng_col
+
+from src.text_content import (
+    COLOR_MAPPING,
+    CREDITS_TEXT,
+    HEADERS_MAPPING,
+    ICON_MAPPING,
+    INTRO_TEXT_AR,
+    INTRO_TEXT_EN,
+    INTRO_TEXT_FR,
+    LOGO,
+    REVIEW_TEXT,
+    SLOGAN,
+)
+from src.utils import init_map, parse_gg_sheet
+
+TOKEN = os.environ.get("HF_TOKEN", None)
+REQUESTS_URL = "https://docs.google.com/spreadsheets/d/1gYoBBiBo1L18IVakHkf3t1fOGvHWb23loadyFZUeHJs/edit#gid=966953708"
+INTERVENTIONS_URL = (
+    "https://docs.google.com/spreadsheets/d/1eXOTqunOWWP8FRdENPs4cU9ulISm4XZWYJJNR1-SrwY/edit#gid=2089222765"
+)
+api = HfApi(TOKEN)
+
+
+# Initialize Streamlit Config
+st.set_page_config(layout="wide", initial_sidebar_state="collapsed", page_icon="🤝", page_title="Nt3awnou نتعاونو")
+
+# Initialize States
+if "sleep_time" not in st.session_state:
+    st.session_state.sleep_time = 2
+if "auto_refresh" not in st.session_state:
+    st.session_state.auto_refresh = False
+
+auto_refresh = st.sidebar.checkbox("Auto Refresh?", st.session_state.auto_refresh)
+if auto_refresh:
+    number = st.sidebar.number_input("Refresh rate in seconds", value=st.session_state.sleep_time)
+    st.session_state.sleep_time = number
+
+
+# Streamlit functions
+def display_interventions(interventions_df, m):
+    """Display NGO interventions on the map"""
+    for index, row in interventions_df.iterrows():
+        status = (
+            "Done ✅"
+            if row[interventions_df.columns[5]] != "Intervention prévue dans le futur / Planned future intervention"
+            else "Planned ⌛"
+        )
+        color_mk = (
+            "green"
+            if row[interventions_df.columns[5]] != "Intervention prévue dans le futur / Planned future intervention"
+            else "pink"
+        )
+        intervention_type = row[interventions_df.columns[6]].split("/")[0].strip()
+        org = row[interventions_df.columns[1]]
+        city = row[interventions_df.columns[9]]
+        date = row[interventions_df.columns[4]]
+        intervention_info = f"<b>Status:</b> {status}<br><b>Org:</b> {org}<br><b>Intervention:</b> {intervention_type}<br><b>📅 Date:</b> {date}"
+        if row["latlng"] is None:
+            continue
+        folium.Marker(
+            location=row["latlng"],
+            tooltip=city,
+            popup=folium.Popup(intervention_info, max_width=300),
+            icon=folium.Icon(color=color_mk),
+        ).add_to(m)
+
+
+def show_requests(filtered_df, m):
+    """Display victim requests on the map"""
+    for index, row in filtered_df.iterrows():
+        request_type = row["ما هي احتياجاتك؟ (أضفها إذا لم يتم ذكرها)"]
+        long_lat = row[
+            "هل يمكنك تقديم الإحداثيات الدقيقة للموقع؟ (ادا كنت لا توجد بعين المكان) متلاً \n31.01837503440344, -6.781405948842175"
+        ]
+        maps_url = f"https://maps.google.com/?q={long_lat}"
+        display_text = f'<b>Request Type:</b> {request_type}<br><b>Id:</b> {row["id"]}<br><a href="{maps_url}" target="_blank" rel="noopener noreferrer"><b>Google Maps</b></a>'
+        icon_name = ICON_MAPPING.get(request_type, "info-sign")
+        if row["latlng"] is None:
+            continue
+
+        folium.Marker(
+            location=row["latlng"],
+            tooltip=row["  لأي  جماعة / قيادة / دوار تنتمون ؟"]
+            if not pd.isna(row["  لأي  جماعة / قيادة / دوار تنتمون ؟"])
+            else None,
+            popup=folium.Popup(display_text, max_width=300),
+            icon=folium.Icon(color=COLOR_MAPPING.get(request_type, "blue"), icon=icon_name),
+        ).add_to(m)
+
+
+def display_google_sheet_tables(data_url):
+    """Display the google sheet tables for requests and interventions"""
+    st.markdown(
+        f"""<iframe src="{data_url}" width="100%" height="600px"></iframe>""",
+        unsafe_allow_html=True,
+    )
+
+
+def display_dataframe(df, drop_cols, data_url, search_id=True, status=False):
+    """Display the dataframe in a table"""
+    col_1, col_2 = st.columns([1, 1])
+
+    with col_1:
+        query = st.text_input(
+            "🔍 Search for information / بحث عن المعلومات",
+            key=f"search_requests_{int(search_id)}",
+        )
+    with col_2:
+        if search_id:
+            id_number = st.number_input(
+                "🔍 Search for an id / بحث عن رقم",
+                min_value=0,
+                max_value=len(filtered_df),
+                value=0,
+                step=1,
+            )
+        if status:
+            selected_status = st.selectbox(
+                "🗓️ Status / حالة",
+                ["all / الكل", "Done / تم", "Planned / مخطط لها"],
+                key="status",
+            )
+
+    if query:
+        # Filtering the dataframe based on the query
+        mask = df.apply(lambda row: row.astype(str).str.contains(query).any(), axis=1)
+        display_df = df[mask]
+    else:
+        display_df = df
+
+    display_df = display_df.drop(drop_cols, axis=1)
+
+    if search_id and id_number:
+        display_df = display_df[display_df["id"] == id_number]
+
+    if status:
+        target = "Pouvez-vous nous préciser si vous êtes déjà intervenus ou si vous prévoyez de le faire | Tell us if you already made the intervention, or if you're planning to do it"
+        if selected_status == "Done / تم":
+            display_df = display_df[display_df[target] == "Intervention déjà passée / Past intevention"]
+
+        elif selected_status == "Planned / مخطط لها":
+            display_df = display_df[display_df[target] != "Intervention déjà passée / Past intevention"]
+
+    st.dataframe(display_df, height=500)
+    st.markdown(
+        f"To view the full Google Sheet for advanced filtering go to: {data_url} **لعرض الورقة كاملة، اذهب إلى**"
+    )
+    # if we want to check hidden contact information
+    st.markdown(
+        f"We are hiding contact information to protect the privacy of the victims. If you are an NGO and want to contact the victims, please contact us at nt3awnoumorocco@gmail.com",
+    )
+    # arabic needs rtl
+    st.markdown(
+        f"""
+                <div style="text-align: left;">
+                <a href="mailto:nt3awnoumorocco@gmail.com">nt3awnoumorocco@gmail.com</a> نحن نخفي معلومات الاتصال لحماية خصوصية الضحايا. إذا كنت جمعية وتريد الاتصال بالضحايا، يرجى الاتصال بنا على 
+                </div>
+                """,
+        unsafe_allow_html=True,
+    )
+
+
+def id_review_submission():
+    """Id review submission form"""
+    st.subheader("🔍 Review of requests")
+    st.markdown(REVIEW_TEXT)
+
+    id_to_review = st.number_input("Enter id / أدخل الرقم", min_value=0, max_value=len(df), value=0, step=1)
+    reason_for_review = st.text_area("Explain why / أدخل سبب المراجعة")
+    if st.button("Submit / أرسل"):
+        if reason_for_review == "":
+            st.error("Please enter a reason / الرجاء إدخال سبب")
+        else:
+            filename = f"review_id_{id_to_review}_{datetime.now().strftime('%Y-%m-%d_%H-%M-%S')}.txt"
+            with open(filename, "w") as f:
+                f.write(f"id: {id_to_review}, explanation: {reason_for_review}\n")
+            api.upload_file(
+                path_or_fileobj=filename,
+                path_in_repo=filename,
+                repo_id="nt3awnou/review_requests",
+                repo_type="dataset",
+            )
+            st.success("Submitted at https://huggingface.co/datasets/nt3awnou/review_requests/ تم الإرسال")
+
+
+# Logo and Title
+st.markdown(LOGO, unsafe_allow_html=True)
+# st.title("Nt3awnou نتعاونو")
+st.markdown(SLOGAN, unsafe_allow_html=True)
+
+# Load data and initialize map with plugins
+df = parse_gg_sheet(REQUESTS_URL)
+df = add_latlng_col(df, process_column=15)
+interventions_df = parse_gg_sheet(INTERVENTIONS_URL)
+interventions_df = add_latlng_col(interventions_df, process_column=12)
+m = init_map()
+
+# Selection of requests
+options = [
+    "إغاثة",
+    "مساعدة طبية",
+    "مأوى",
+    "طعام وماء",
+    "مخاطر (تسرب الغاز، تلف في الخدمات العامة...)",
+]
+selected_options = []
+
+# with tab_en:
+#     st.markdown("👉 **Choose request type**")
+# with tab_ar:
+#     st.markdown("👉 **اختر نوع الطلب**")
+# with tab_fr:
+#     st.markdown("👉 **Choisissez le type de demande**")
+
+st.markdown("👉 **Choose request type | Choissisez le type de demande | اختر نوع الطلب**")
+col1, col2, col3, col4, col5 = st.columns([2, 3, 2, 3, 4])
+cols = [col1, col2, col3, col4, col5]
+
+for i, option in enumerate(options):
+    checked = cols[i].checkbox(HEADERS_MAPPING[option], value=True)
+    if checked:
+        selected_options.append(option)
+
+df["id"] = df.index
+filtered_df = df[df["ما هي احتياجاتك؟ (أضفها إذا لم يتم ذكرها)"].isin(selected_options)]
+selected_headers = [HEADERS_MAPPING[request] for request in selected_options]
+
+# Selection of interventions
+show_interventions = st.checkbox(
+    "Display Interventions | عرض عمليات المساعدة | Afficher les interventions",
+    value=True,
+)
+
+if show_interventions:
+    # print(interventions_df.columns)
+    display_interventions(interventions_df, m)
+
+# Show requests
+show_requests(filtered_df, m)
+
+st_data = st_folium(m, use_container_width=True)
+tab_ar, tab_en, tab_fr = st.tabs(["العربية", "English", "Français"])
+
+
+with tab_en:
+    st.markdown(INTRO_TEXT_EN, unsafe_allow_html=True)
+with tab_ar:
+    st.markdown(INTRO_TEXT_AR, unsafe_allow_html=True)
+with tab_fr:
+    st.markdown(INTRO_TEXT_FR, unsafe_allow_html=True)
+
+# Requests table
+st.divider()
+st.subheader("📝 **Table of requests / جدول الطلبات**")
+drop_cols = [
+    "(عند الامكان) رقم هاتف شخص موجود في عين المكان",
+    "الرجاء الضغط على الرابط التالي لمعرفة موقعك إذا كان متاحا",
+    "GeoStamp",
+    "GeoCode",
+    "GeoAddress",
+    "Status",
+]
+display_dataframe(filtered_df, drop_cols, REQUESTS_URL, search_id=True)
+
+# Interventions table
+st.divider()
+st.subheader("📝 **Table of interventions / جدول التدخلات**")
+display_dataframe(
+    interventions_df,
+    [], # We show NGOs contact information
+    INTERVENTIONS_URL,
+    search_id=False,
+    status=True,
+)
+
+# Submit an id for review
+st.divider()
+id_review_submission()
+
+
+# Credits
+st.markdown(
+    CREDITS_TEXT,
+    unsafe_allow_html=True,
+)
+if auto_refresh:
+    time.sleep(number)
+    st.experimental_rerun()

requirements.txt

@@ -0,0 +1,2 @@
+folium
+streamlit_folium

src/map_utils.py

@@ -0,0 +1,102 @@
+from branca.element import Template, MacroElement
+
+
+template = """
+{% macro html(this, kwargs) %}
+
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>jQuery UI Draggable - Default functionality</title>
+  <link rel="stylesheet" href="//code.jquery.com/ui/1.12.1/themes/base/jquery-ui.css">
+
+  <script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+  <script src="https://code.jquery.com/ui/1.12.1/jquery-ui.js"></script>
+  
+  <script>
+  $( function() {
+    $( "#maplegend" ).draggable({
+                    start: function (event, ui) {
+                        $(this).css({
+                            right: "auto",
+                            top: "auto",
+                            bottom: "auto"
+                        });
+                    }
+                });
+});
+
+  </script>
+</head>
+<body>
+
+ 
+<div id='maplegend' class='maplegend' 
+    style='position: absolute; z-index:9999; border:2px solid grey; background-color:rgba(255, 255, 255, 0.8);
+     border-radius:6px; padding: 10px; font-size:14px; right: 20px; bottom: 20px;'>
+     
+<div class='legend-title'>Legend / مفتاح الخريطة</div>
+<div class='legend-scale'>
+  <ul class='legend-labels'>
+    <li><span style='background:#CE3C28;opacity:0.7;'></span>Rescue / إغاثة</li>
+    <li><span style='background:#ED922E;opacity:0.7;'></span>Medical Assistance / مساعدة طبية</li>
+    <li><span style='background:#FFCA92;opacity:0.7;'></span>Shelter / مأوى</li>
+    <li><span style='background:#37A8DA;opacity:0.7;'></span>Food & Water / طعام وماء</li>
+    <li><span style='background:#575757;opacity:0.7;'></span>Danger / مخاطر (تسرب الغاز، تلف في الخدمات العامة...)</li>
+    <li><span style='background:#6EAA25;opacity:0.7;'></span>Done / تم</li>
+    <li><span style='background:#FF91E8;opacity:0.7;'></span>Planned / مخطط لها</li>
+  </ul>
+</div>
+</div>
+ 
+</body>
+</html>
+
+<style type='text/css'>
+  .maplegend .legend-title {
+    text-align: left;
+    margin-bottom: 5px;
+    font-weight: bold;
+    font-size: 90%;
+    color: #333;
+    }
+  .maplegend .legend-scale ul {
+    margin: 0;
+    margin-bottom: 5px;
+    padding: 0;
+    float: left;
+    list-style: none;
+    }
+  .maplegend .legend-scale ul li {
+    font-size: 80%;
+    list-style: none;
+    margin-left: 0;
+    line-height: 18px;
+    margin-bottom: 2px;
+    color: #111;
+    }
+  .maplegend ul.legend-labels li span {
+    display: block;
+    float: left;
+    height: 16px;
+    width: 30px;
+    margin-right: 5px;
+    margin-left: 0;
+    border: 1px solid #999;
+    }
+  .maplegend .legend-source {
+    font-size: 80%;
+    color: #777;
+    clear: both;
+    }
+  .maplegend a {
+    color: #777;
+    }
+</style>
+{% endmacro %}"""
+legend_macro = MacroElement()
+legend_macro._template = Template(template)
+
+__all__ = ["legend_macro"]

src/text_content.py

@@ -0,0 +1,88 @@
+INTRO_TEXT_EN = """
+                <div style="text-align: left;">
+    Nt3awnou نتعاونو is a collaborative platform dedicated to aiding individuals impacted by the recent earthquake in Morocco. Our core mission is to streamline and coordinate timely assistance for everyone affected. How do we achieve this? We assist those in need by allowing them to communicate their location and the specific aid they require, either by completing a form or sending a voice message via WhatsApp to a designated number. Once we receive and process this information, it can be viewed in our dashboard, which allows NGOs to organize and precisely target their interventions, ensuring swift assistance reaches those in need. Any organization that has taken initiative in a particular area can notify us by completing a dedicated form. This data is also incorporated into the dashboard so that other NGOs can help affected areas that still haven't received help.
+    Warning : There are still rocks falling down the mountains, making the roads to the affected areas very dangerous. We advise volunteers to donate directly to specialized NGOs.<br>
+    <br> 
+    <b>✉️ You can contact us via email at </b><a href="mailto:nt3awnoumorocco@gmail.com">nt3awnoumorocco@gmail.com</a> <br>
+    <b>📝 Help us report more people in need by filling this form </b><a href="https://forms.gle/nZNCUVog9ka2Vdqu6">https://forms.gle/nZNCUVog9ka2Vdqu6</a> <br>
+    <b>📝 NGOs can report their interventions by filling this form </b><a href="https://forms.gle/PsNSuHHjTTgwQMmVA">https://forms.gle/PsNSuHHjTTgwQMmVA</a>  
+    </div>
+    <br> 
+                """
+
+INTRO_TEXT_AR = """
+        <div style="text-align: right;">
+
+    نتعاونو هي منصة تعاونية لمساعدة الأفراد المتضررين من الزلزال الأخير في المغرب. مهمتنا هي تسهيل تقديم المساعدة في الوقت المناسب و بفاعلية و تنظيم لجميع المتضررين. كيفاش؟ كنعاونو الناس لي محتاجين للمساعدة إعلمونا بمكانهم و نوع المساعدة لي محتاجين ليها سواء عن طريق ملأ الاستمارة أو عن طريق إرسال تسجيل صوتي عبر واتساب إلى رقم مخصص. بعد معالجة هاد المعلومات، كنجمعوهم فخريطة كتمكن الجمعيات من تنظيم و استهداف تدخلاتهم بدقة باش توصل المساعدة للناس لي محتاجين في وقت أسرع. و كل جمعية قامت باللازم في منطقة معينة تقدر تعلمنا عن طريق ملأ استمارة مخصصة لهاد الأمر. هاد المعلومات كذلك كتضاف للخريطة باش باقي الجمعيات يتاجهو لمناطق أخرى مازال ماوصلاتهم مساعدة.
+    تحذير : نظرا لخطورة الطرقان بسبب الحجر اللي كيطيح من الجبال، ننصح المتطوعين اللي بغاو يساعدو المناطق المتضررة يتبرعو عن طريق الجمعيات المختصة. 
+    <br> 
+    nt3awnoumorocco@gmail.com <b>المتطوعين ليبغاو يعاونوا يقدرو يتصلوا معنا عبر البريد ✉️   </b><br>
+    https://forms.gle/nZNCUVog9ka2Vdqu6 <b>: ساعدونا نبلغو الناس ليمحتاجين فهاد الاستمارة 📝 </b><br>
+    https://forms.gle/PsNSuHHjTTgwQMmVA <b>: الجمعيات لي عندهم تدخلات يقدرو يبلغونا عبر هاد الاستمار  ة📝</b>
+        </div>
+    <br> 
+        """
+        
+INTRO_TEXT_FR = """
+    <div style="text-align: left;">
+    Nt3awnou نتعاونو est une plateforme collaborative dédiée à l'aide aux personnes touchées par le récent tremblement de terre au Maroc. Notre mission principale est de rationaliser et de coordonner une assistance rapide pour toutes les personnes touchées. Comment y parvenons-nous ? Nous aidons les personnes dans le besoin en leur permettant de communiquer leur localisation et l'aide spécifique dont elles ont besoin, soit en remplissant un formulaire, soit en envoyant un message vocal via WhatsApp à un numéro désigné. Une fois reçues et traitées, ces informations peuvent être consultées dans notre tableau de bord, qui permet aux associations d'organiser et de cibler précisément leurs interventions, afin que l'aide parvienne rapidement à ceux qui en ont besoin. Toute organisation ayant pris une initiative dans une zone particulière peut nous en informer en remplissant un formulaire prévu à cet effet. Ces données sont également intégrées au tableau de bord afin que d'autres associations puissent aider les zones touchées qui n'ont pas encore reçu d'aide.
+    Avertissement : Il y a encore des chutes de pierres dans les montagnes, ce qui rend les routes vers les zones touchées très dangereuses. Nous conseillons aux volontaires de faire des dons directement aux associations spécialisées.
+    <br> 
+    <b>✉️ Vous pouvez nous contacter par courrier électronique à l'adresse suivante : </b>nt3awnoumorocco@gmail.com <br>
+    <b>📝 Aidez-nous à signaler plus de personnes dans le besoin en remplissant ce formulaire : </b>https://forms.gle/nZNCUVog9ka2Vdqu6 <br>
+    <b>📝 Les associations peuvent signaler leurs interventions en remplissant ce formulaire :</b>https://forms.gle/PsNSuHHjTTgwQMmVA
+    </div>
+    <br> 
+    """
+
+SLOGAN = """
+    <div style="text-align: center;">
+    <h4>وَمَنْ أَحْيَاهَا فَكَأَنَّمَا أَحْيَا النَّاسَ جَمِيعاً</h4>
+    </div>
+    """
+
+HEADERS_MAPPING = {
+    "إغاثة" : "Rescue | إغاثة | Secours",
+    "مساعدة طبية": "Medical Assistance | مساعدة طبية | Assistance médicale",
+    "مأوى": "Shelter | مأوى | Abri",
+    "طعام وماء": "Food & Water | طعام وماء | Nourriture et eau",
+    "مخاطر (تسرب الغاز، تلف في الخدمات العامة...)": "Danger | مخاطر (تسرب الغاز، تلف في الخدمات العامة...) | Danger",
+}
+
+COLOR_MAPPING = {
+    "إغاثة": "red",
+    "مساعدة طبية": "orange",
+    "مأوى": "beige",
+    "طعام وماء": "blue",
+    "مخاطر (تسرب الغاز، تلف في الخدمات العامة...)": "gray",
+}
+
+ICON_MAPPING = {
+    "إغاثة": "bell",        # life ring icon for rescue
+    "مساعدة طبية": "heart",     # medical kit for medical assistance
+    "مأوى": "home",              # home icon for shelter
+    "طعام وماء": "cutlery",      # cutlery (fork and knife) for food & water
+    "مخاطر (تسرب الغاز، تلف في الخدمات العامة...)": "Warning"  # warning triangle for dangers
+}
+
+CREDITS_TEXT = """
+    <hr>
+    <div style="text-align: center;">
+    <p>By <b>Moroccans</b> for <b>Moroccans</b> 🤝</p>
+    <p>Bot powered by <a href="https://www.annarabic.com/">Annarabic</a></p>
+    <p>Collaboration made possible thanks to <a href="https://summerschool.morocco.ai/">AI Summer School</a></p>
+    """
+
+LOGO = """
+    <style>
+            .block-container {
+                padding-top: 1rem;
+                padding-bottom: 0rem;
+            }
+    </style>
+    <div style="text-align: center;">
+    <img src="https://storage.googleapis.com/storage-annarabic/Nt3awnou(1).png" width="200" height="200">
+    </div>
+    """
+
+REVIEW_TEXT = """**If a request should be reviewed or dropped submit its id here/ إذا كان يجب مراجعة أو حذف طلب، أدخل رقمه هنا:**"""

src/utils.py

@@ -0,0 +1,142 @@
+import folium
+import pandas as pd
+from folium import plugins
+from src.map_utils import legend_macro
+
+
+EPICENTER_LOCATION = [31.12210171476489, -8.42945837915193]
+BORDER_COLOR = "black"
+
+def parse_gg_sheet(url):
+    url = url.replace("edit#gid=", "export?format=csv&gid=")
+    df = pd.read_csv(url, on_bad_lines="warn")
+    return df
+
+# Session for Requests
+# session = requests.Session()
+# @st.cache_data(persist=True)
+# def parse_latlng_from_link(url):
+#     try:
+#         # extract latitude and longitude from gmaps link
+#         if "@" not in url:
+#             resp = session.head(url, allow_redirects=True)
+#             url = resp.url
+#         latlng = url.split("@")[1].split(",")[0:2]
+#         return [float(latlng[0]), float(latlng[1])]
+#     except Exception as e:
+#         return None
+
+def add_latlng_col(df, process_column):
+    """Add a latlng column to the dataframe"""
+    df = df.assign(latlng=df.iloc[:, process_column].apply(parse_latlng))
+    return df
+
+# parse latlng (column 4) to [lat, lng]
+import re
+def parse_latlng(latlng):
+    if pd.isna(latlng):
+        return None
+        # lat, lng = latlng.split(",")
+        # return [float(lat), float(lng)]
+
+    try:
+        # check if it matches (30.9529832, -7.1010705) or (30.9529832,-7.1010705)
+        if re.match(r"\(\d+\.\d+,\s?-\d+\.\d+\)", latlng):
+            lat, lng = latlng[1:-1].split(",")
+            return [float(lat), float(lng)]
+        # check of it matches 30.9529832, -7.1010705 or 30.9529832,-7.1010705
+        elif re.match(r"\d+\.\d+,\s?-\d+\.\d+", latlng):
+            lat, lng = latlng.split(",")
+            return [float(lat), float(lng)]
+        # check if it matches 30,9529832, -7,1010705 or 30,9529832,-7,1010705, match1=30,9529832 and match2=-7,1010705
+        elif re.match(r"\d+,\d+,\s?-\d+,\d+", latlng):
+            d1, d2, d3, d4 = latlng.split(",")
+            return [float(".".join([d1, d2])), float(".".join([d3, d4]))]
+    except Exception as e:
+        print(f"Error parsing latlng: {latlng}  Reason: {e}")
+        return None
+    print(f"Error parsing latlng: {latlng}")
+    return None
+
+def add_epicentre_to_map(map_obj):
+    icon_epicentre = folium.plugins.BeautifyIcon(
+        icon='spinner',
+        spin=True,
+        border_color='#b3334f',
+        background_color='#b3334f',
+        text_color='white'
+    )
+    folium.Marker(location=EPICENTER_LOCATION, 
+                  popup="Epicenter مركز الزلزال", 
+                  icon=icon_epicentre).add_to(map_obj)
+
+
+def add_danger_distances_to_map(map_obj):
+    Danger_Distances_group = folium.FeatureGroup(name='Danger distances - earthquake magnitude 7 | مسافات الخطر - قوة الزلازل 7').add_to(map_obj)
+    
+    zones = [
+        {"radius": 100000, "fill_opacity": 0.1, "weight": 1, "fill_color": "yellow", "tooltip": "50 to 100 km - Moderate risk area | منطقة خطر معتدلة"},
+        {"radius": 50000, "fill_opacity": 0.1, "weight": 1, "fill_color": "orange", "tooltip": "30 to 50 km - High risk zone | منطقة عالية المخاطر"},
+        {"radius": 30000, "fill_opacity": 0.2, "weight": 1, "fill_color": "#FF0000", "tooltip": "10 to 30 km - Very high risk zone | منطقة شديدة الخطورة"},
+        {"radius": 10000, "fill_opacity": 0.2, "weight": 0.2, "fill_color": "#8B0000", "tooltip": "0 to 10km - direct impact zone | منطقة التأثير المباشر"}
+    ]
+
+    for zone in zones:
+        folium.Circle(
+            location=EPICENTER_LOCATION,
+            radius=zone["radius"],
+            color=BORDER_COLOR,
+            weight=zone["weight"],
+            fill_opacity=zone["fill_opacity"],
+            opacity=zone["fill_opacity"],  # Assuming border opacity should match fill_opacity
+            fill_color=zone["fill_color"],
+            tooltip=zone["tooltip"],
+        ).add_to(Danger_Distances_group)
+
+
+def init_map():
+    m = folium.Map(
+        location=[31.228674, -7.992047],
+        zoom_start=8.5,
+        min_zoom=8.5,
+        max_lat=35.628674,
+        min_lat=29.628674,
+        max_lon=-4.992047,
+        min_lon=-10.992047,
+        max_bounds=True,
+    )
+    # Add a search bar to the map
+    plugins.Geocoder(
+        collapsed=False,
+        position="topright",
+        placeholder="Search | البحث",
+    ).add_to(m)
+
+    # Add Fullscreen button to the map
+    plugins.Fullscreen(
+        position="topright",
+        title="Expand me | تكبير الخريطة",
+        title_cancel="Exit me | تصغير الخريطة",
+        force_separate_button=True,
+    ).add_to(m)
+
+    # Satellite View from Mapbox
+    tileurl = "https://api.mapbox.com/styles/v1/phd2020/clmer2mra01d001pbgjkictpt/tiles/256/{z}/{x}/{y}@2x?access_token=pk.eyJ1IjoicGhkMjAyMCIsImEiOiJja29lZzFwZmUwNHkzMm5wMjZnYjVvcGltIn0.tE0ritrelQOyLdKUH6hgOw"
+    folium.TileLayer(
+        tiles=tileurl,
+        attr="Satellite View",
+        name="Satellite View | عرض القمر الصناعي",
+        overlay=False,
+        control=True,
+    ).add_to(m)
+
+    # Add danger zones
+    add_epicentre_to_map(m)
+    add_danger_distances_to_map(m)
+
+    # Add a LayerControl to the map to toggle between layers (Satellite View and Default One)
+    folium.LayerControl().add_to(m)
+
+    # Macro to add legend
+    m.get_root().add_child(legend_macro)
+    return m