Add gradio app (#1)

* Add gradio app

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

.github/workflows/sync-hf.yml

@@ -0,0 +1,20 @@
+name: Sync to Hugging Face hub
+on:
+  push:
+    branches: [main]
+
+  # to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+jobs:
+  sync-to-hub:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          lfs: true
+      - name: Push to hub
+        env:
+          HF_TOKEN: ${{ secrets.HF_TOKEN }}
+        run: git push --force https://giswqs:$HF_TOKEN@huggingface.co/spaces/giswqs/ee-tile-request main

.gitignore

@@ -174,9 +174,9 @@ cython_debug/
 .abstra/
 
 # Visual Studio Code
-#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
 #  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
-#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  and can be added to the global gitignore or merged into this file. However, if you prefer,
 #  you could uncomment the following to ignore the enitre vscode folder
 # .vscode/
 

.pre-commit-config.yaml

@@ -0,0 +1,32 @@
+repos:
+    - repo: https://github.com/pre-commit/pre-commit-hooks
+      rev: v5.0.0
+      hooks:
+          - id: check-toml
+          - id: check-yaml
+          - id: end-of-file-fixer
+            types: [python]
+          - id: trailing-whitespace
+          - id: requirements-txt-fixer
+          - id: check-added-large-files
+            args: ["--maxkb=500"]
+
+    - repo: https://github.com/psf/black
+      rev: 25.1.0
+      hooks:
+          - id: black-jupyter
+
+    - repo: https://github.com/codespell-project/codespell
+      rev: v2.4.1
+      hooks:
+          - id: codespell
+            args:
+                [
+                    "--ignore-words-list=aci,acount,acounts,fallow,ges,hart,hist,nd,ned,ois,wqs,watermask,tre,mape",
+                    "--skip=*.csv,*.geojson,*.json,*.yml*.js,*.html,*cff,*.pdf",
+                ]
+
+    - repo: https://github.com/kynan/nbstripout
+      rev: 0.8.1
+      hooks:
+          - id: nbstripout

Dockerfile

@@ -0,0 +1,14 @@
+FROM python:3.12-slim
+
+RUN apt-get update && apt-get install -y curl git npm && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+COPY requirements.txt .
+COPY main.py .
+
+RUN pip install --no-cache-dir -r requirements.txt
+
+EXPOSE 7860
+
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "7860"]

README.md

@@ -0,0 +1,12 @@
+---
+title: Ee Tile Request
+emoji: 😻
+colorFrom: pink
+colorTo: gray
+sdk: docker
+pinned: false
+license: mit
+short_description: Earth Engine Tile URL Generator
+---
+
+Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

main.py

@@ -0,0 +1,96 @@
+import os
+import json
+import ee
+import geemap
+import gradio as gr
+from fastapi import FastAPI, HTTPException
+from pydantic import BaseModel
+from geemap.ee_tile_layers import _get_tile_url_format, _validate_palette
+from starlette.middleware.cors import CORSMiddleware
+
+# Earth Engine auth
+if "EARTHENGINE_TOKEN" not in os.environ:
+    raise RuntimeError("EARTHENGINE_TOKEN environment variable not found")
+
+try:
+    geemap.ee_initialize()
+except Exception as e:
+    raise RuntimeError(f"Earth Engine authentication failed: {e}")
+
+
+# ---- Shared Tile Logic ----
+def get_tile(asset_id, vis_params=None):
+    try:
+        if asset_id.startswith("ee."):
+            ee_object = eval(asset_id)
+        else:
+            data_dict = ee.data.getAsset(asset_id)
+            data_type = data_dict["type"]
+            if data_type == "IMAGE":
+                ee_object = ee.Image(asset_id)
+            elif data_type == "IMAGE_COLLECTION":
+                ee_object = ee.ImageCollection(asset_id)
+            elif data_type in ["TABLE", "TABLE_COLLECTION"]:
+                ee_object = ee.FeatureCollection(asset_id)
+            else:
+                raise ValueError(f"Unsupported data type: {data_type}")
+
+        if vis_params is None:
+            vis_params = {}
+        if isinstance(vis_params, str):
+            if len(vis_params) == 0:
+                vis_params = "{}"
+            if vis_params.startswith("{") and vis_params.endswith("}"):
+                vis_params = json.loads(vis_params)
+            else:
+                raise ValueError(f"Unsupported vis_params type: {type(vis_params)}")
+        elif isinstance(vis_params, dict):
+            pass
+        else:
+            raise ValueError(f"Unsupported vis_params type: {type(vis_params)}")
+
+        if "palette" in vis_params:
+            vis_params["palette"] = _validate_palette(vis_params["palette"])
+
+        url = _get_tile_url_format(ee_object, vis_params)
+        return url
+    except Exception as e:
+        return f"Error: {str(e)}"
+
+
+# ---- FastAPI ----
+app = FastAPI()
+app.add_middleware(
+    CORSMiddleware, allow_origins=["*"], allow_methods=["*"], allow_headers=["*"]
+)
+
+
+class TileRequest(BaseModel):
+    asset_id: str
+    vis_params: dict | None = None
+
+
+@app.post("/tile")
+def get_tile_api(req: TileRequest):
+    result = get_tile(req.asset_id, req.vis_params)
+    if isinstance(result, str) and result.startswith("Error"):
+        raise HTTPException(status_code=400, detail=result)
+    return {"tile_url": result}
+
+
+# ---- Gradio UI ----
+gradio_ui = gr.Interface(
+    fn=get_tile,
+    inputs=[
+        gr.Textbox(label="Earth Engine Asset ID", placeholder="e.g., USGS/SRTMGL1_003"),
+        gr.Textbox(
+            label="Visualization Parameters (JSON)",
+            placeholder='{"min":0,"max":5000,"palette":"terrain"}',
+        ),
+    ],
+    outputs="text",
+    title="Earth Engine Tile URL Generator",
+    description="Supports ee.Image, ee.ImageCollection, ee.FeatureCollection. Tile URL is suitable for basemap usage.",
+)
+
+app = gr.mount_gradio_app(app, gradio_ui, path="/")

requirements.txt

@@ -0,0 +1,4 @@
+fastapi
+git+https://github.com/gee-community/geemap.git
+gradio
+uvicorn