# yaml-language-server: $schema=https://schema.zeabur.app/template.json
apiVersion: zeabur.com/v1
kind: Template
metadata:
    name: Docker Static Maps API
spec:
    description: Generate static map images via a lightweight REST API
    icon: https://dietrichmax.github.io/docker-staticmaps/img/favicon.ico
    variables:
        - key: PUBLIC_DOMAIN
          type: DOMAIN
          name: Domain
          description: The domain you want to bind to your Docker Static Maps API instance.
    tags:
        - Map
        - API
        - Image Generation
        - Developer Tool
    readme: "# Docker Static Maps API \U0001F5FA️\n\n**Generate static map images via a lightweight REST API**\n\ndocker-staticmaps is an open-source API for rendering static map images. Easily create maps with markers, polygons, circles, polylines or text, making it perfect for embedding map images on websites or apps.\n\nThe Dockerfile and the README are from this original repository: <https://github.com/dietrichmax/docker-staticmaps>\n\n## \U0001F680 Features\n\n- ✅ **Generate static maps** with markers, polygons, circles, polylines and text\n- \U0001F30D **Supports multiple basemaps** (OpenStreetMap, Esri, Stamen, Carto, custom tile server)\n- ⚡ **Easy-to-use REST API** - simple integration with any frontend or backend\n- \U0001F433 **Docker-ready** for fast, lightweight deployment\n- \U0001F9CA **Tile and image caching** for performance\n- \U0001F6A6 **Built-in rate limiting** per IP to protect against abuse\n\n## \U0001F4D6 Quick Start\n\nOnce deployed, you can access the interactive playground at your domain, or make API requests directly.\n\n### Example API Request\n\n```\nGET https://your-domain.zeabur.app/api/staticmaps?width=1000&height=1000&center=-18.2871,147.6992&zoom=9&basemap=satellite\n```\n\n### Interactive Playground\n\nVisit your deployed domain to access the interactive playground where you can:\n- Configure map settings visually\n- Add markers, polygons, and other features\n- Preview the generated map in real-time\n- Copy the API URL for integration\n\n## \U0001F4DA Documentation\n\nFor detailed API documentation, supported basemaps, and advanced features, visit:\nhttps://dietrichmax.github.io/docker-staticmaps/\n\n## License\n\nThis project is licensed under the [GNU Affero General Public License v3.0 (AGPL-3.0)](https://www.gnu.org/licenses/agpl-3.0.en.html)\n\n> ```\n> docker-staticmaps\n> Copyright (C) 2026 Max Dietrich\n>\n> This program is free software: you can redistribute it and/or modify\n> it under the terms of the GNU Affero General Public License as published\n> by the Free Software Foundation, either version 3 of the License, or\n> (at your option) any later version.\n> ```\n"
    services:
        - name: docker-staticmaps
          icon: https://dietrichmax.github.io/docker-staticmaps/img/favicon.ico
          template: PREBUILT
          spec:
            source:
                image: mxdcodes/docker-staticmaps:latest
            ports:
                - id: web
                  port: 3000
                  type: HTTP
          domainKey: PUBLIC_DOMAIN
localization:
    zh-TW:
        description: 透過輕量級 REST API 生成靜態地圖圖片
        variables:
            - key: PUBLIC_DOMAIN
              type: DOMAIN
              name: 網域
              description: 你想綁定到 Docker Static Maps API 的網域
        readme: "# Docker 靜態地圖 API \U0001F5FA️\n\n**透過輕量級 REST API 產生靜態地圖圖片**\n\ndocker-staticmaps 是一個用於渲染靜態地圖圖片的開源 API。您可以輕鬆建立帶有標記、多邊形、圓形、折線或文字的地圖，非常適合將地圖圖片嵌入網站或應用程式中。\n\nDockerfile 與 README 皆源自此原始儲存庫：<https://github.com/dietrichmax/docker-staticmaps>\n\n## \U0001F680 功能特色\n\n* ✅ **產生靜態地圖**：支援標記、多邊形、圓形、折線與文字\n* \U0001F30D **支援多種底圖**：(OpenStreetMap, Esri, Stamen, Carto, 自定義圖磚伺服器)\n* ⚡ **易於使用的 REST API**：可輕鬆與任何前端或後端整合\n* \U0001F433 **支援 Docker**：實現快速、輕量化的佈署\n* \U0001F9CA **圖磚與圖片快取**：提升效能表現\n* \U0001F6A6 **內建 IP 流量限制**：防止惡意濫用\n\n## \U0001F4D6 快速上手\n\n佈署完成後，您可以透過您的網域存取互動式遊樂場 (Playground)，或直接發送 API 請求。\n\n### API 請求範例\n\n```\nGET https://your-domain.zeabur.app/api/staticmaps?width=1000&height=1000&center=-18.2871,147.6992&zoom=9&basemap=satellite\n```\n\n### 互動式遊樂場\n\n造訪您佈署的網域以進入互動式遊樂場，您可以在該處：\n* 以視覺化方式設定地圖參數\n* 新增標記、多邊形及其他功能\n* 即時預覽產生的地圖\n* 複製 API 網址以便整合\n\n## \U0001F4DA 文件\n\n如需詳細的 API 文件、支援的底圖以及進階功能，請造訪：\nhttps://dietrichmax.github.io/docker-staticmaps/\n\n## 授權條款\n\n本專案採用 [GNU Affero General Public License v3.0 (AGPL-3.0)](https://www.gnu.org/licenses/agpl-3.0.en.html) 授權。\n\n> ```\n> docker-staticmaps\n> Copyright (C) 2026 Max Dietrich\n>\n> This program is free software: you can redistribute it and/or modify\n> it under the terms of the GNU Affero General Public License as published\n> by the Free Software Foundation, either version 3 of the License, or\n> (at your option) any later version.\n> ```\n"