geo-engine-python 0.1.1__py3-none-any.whl → 0.1.3__py3-none-any.whl

geo_engine_python-0.1.3.dist-info/METADATA

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: geo-engine-python
+Version: 0.1.3
+Summary: SDK oficial para Geo-Engine: Rastreo y Geofencing
+Home-page: https://github.com/AlexG695/geo-engine-python
+Author: AlexG695
+Author-email: AlexG <alexg@geoengine.dev>
+Project-URL: Homepage, https://geoengine.dev
+Project-URL: Bug Tracker, https://github.com/AlexG695/geo-engine/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# 🐍 Geo-Engine Python SDK
+
+Cliente oficial en **Python** para interactuar con la plataforma **Geo-Engine**.
+Permite enviar ubicaciones en tiempo real, gestionar geocercas y consumir la API de Geo-Engine desde aplicaciones **Django**, **Flask**, scripts o entornos de **Data Science**.
+
+Diseñado para ser **simple**, **rápido** y **fácil de integrar**.
+
+---
+
+## 🚀 Instalación
+
+Instala el SDK usando `pip`:
+
+```bash
+pip install geo-engine-python
+```
+
+---
+
+## ⚡ Uso Rápido
+
+Envía la ubicación de un dispositivo en pocos pasos:
+
+```python
+from geo_engine import GeoEngine
+
+# 1. Inicializar el cliente
+# Por defecto se conecta al entorno de producción
+client = GeoEngine(api_key="sk_live_123456")
+
+# 2. Enviar ubicación
+try:
+    res = client.send_location(
+        device_id="camion-01",
+        lat=19.4326,
+        lng=-99.1332
+    )
+    print(f"✅ Enviado: {res}")
+except Exception as e:
+    print(f"❌ Error: {e}")
+```
+
+---
+
+## 🔧 Configuración Avanzada
+
+Puedes personalizar la configuración para conectarte a otros entornos (por ejemplo, local o staging) o modificar URLs internas:
+
+```python
+client = GeoEngine(
+    api_key="sk_test_...",
+    ingest_url="http://localhost:8080",
+    management_url="http://localhost:8081"
+)
+```
+
+---
+
+## 🧩 Casos de Uso Comunes
+
+* 📍 **Tracking en tiempo real** de vehículos o dispositivos IoT
+* 🚚 **Logística y última milla**
+* 🗺️ **Geocercas** y eventos por entrada/salida
+* 📊 **Análisis de datos geoespaciales** en notebooks o pipelines
+
+---
+
+## 🔐 Autenticación
+
+El SDK utiliza **API Keys** para autenticarse.
+Asegúrate de mantenerlas seguras y **no exponerlas en el frontend**.
+
+```python
+GeoEngine(api_key="sk_live_...")
+```
+
+---
+
+## 🧪 Compatibilidad
+
+* Python **3.8+**
+* Funciona con:
+
+  * Django
+  * Flask
+  * FastAPI
+  * Scripts CLI
+  * Jupyter / Data Science
+
+---
+
+## 📄 Licencia
+
+MIT © Geo-Engine
+
+---
+
+## 🤝 Soporte
+
+¿Tienes dudas o sugerencias?
+Abre un issue o contáctanos en **[support@geoengine.dev](mailto:support@geoengine.dev)**
+
+---

geo_engine_python-0.1.3.dist-info/RECORD

@@ -0,0 +1,5 @@
+geoengine/__init__.py,sha256=X_uLLSuqTVF6kJ1T66ms7krwwHNq9a6RzQitoya1yv8,45
+geo_engine_python-0.1.3.dist-info/METADATA,sha256=i--yZU0q98c24YT9UFWj4nbJdIiPpsFLKRG-SR8OkWY,2697
+geo_engine_python-0.1.3.dist-info/WHEEL,sha256=lTU6B6eIfYoiQJTZNc-fyaR6BpL6ehTzU3xGYxn2n8k,91
+geo_engine_python-0.1.3.dist-info/top_level.txt,sha256=bqE5zIDfI6saPEFHhCIwqCBOhsiQ998LGjP_srSIg9E,10
+geo_engine_python-0.1.3.dist-info/RECORD,,

{geo_engine_python-0.1.1.dist-info → geo_engine_python-0.1.3.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (78.1.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

geoengine/__init__.py

@@ -0,0 +1 @@
+from .client import GeoEngine, GeoEngineError

geo_engine_python-0.1.1.dist-info/METADATA

@@ -1,13 +0,0 @@
-Metadata-Version: 2.4
-Name: geo-engine-python
-Version: 0.1.1
-Summary: SDK oficial para Geo-Engine: Rastreo y Geofencing
-Author-email: AlexG <alexg695845@gmail.com>
-Project-URL: Homepage, https://app.geoengine.dev
-Project-URL: Bug Tracker, https://github.com/AlexG695/geo-engine/issues
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-Requires-Dist: requests>=2.25.0

geo_engine_python-0.1.1.dist-info/RECORD

@@ -1,5 +0,0 @@
-geoengine.py,sha256=EvdP--5NJOFvjn-A0QVEqufzTSWIOhCnO_xWMLqopiE,2693
-geo_engine_python-0.1.1.dist-info/METADATA,sha256=i9IuIgv_oBUqlH_NpM4u_GRyhb6WnFf0kB1fe8wle0Q,526
-geo_engine_python-0.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-geo_engine_python-0.1.1.dist-info/top_level.txt,sha256=bqE5zIDfI6saPEFHhCIwqCBOhsiQ998LGjP_srSIg9E,10
-geo_engine_python-0.1.1.dist-info/RECORD,,

geoengine.py

@@ -1,84 +0,0 @@
-import requests
-import time
-import json
-
-class GeoEngine:
-    DEFAULT_MANAGEMENT_URL = "https://api.geoengine.dev"
-    DEFAULT_INGEST_URL = "https://ingest.geoengine.dev"
-
-    def __init__(self, api_key, management_url=None, ingest_url=None):
-        """
-        Inicializa el cliente de GeoEngine.
-        """
-        if not api_key:
-            raise ValueError("GeoEngine: API Key es requerida")
-
-        self.api_key = api_key
-        self.management_url = management_url or self.DEFAULT_MANAGEMENT_URL
-        self.ingest_url = ingest_url or self.DEFAULT_INGEST_URL
-        self.headers = {
-            "Content-Type": "application/json",
-            "X-API-Key": self.api_key,
-            "User-Agent": "GeoEnginePython/1.0.0"
-        }
-
-    def send_location(self, device_id, lat, lng):
-        """
-        Envía una coordenada al motor de ingestión.
-        """
-        payload = {
-            "device_id": device_id,
-            "latitude": float(lat),
-            "longitude": float(lng),
-            "timestamp": int(time.time())
-        }
-
-        try:
-            response = requests.post(
-                f"{self.ingest_url}/ingest",
-                json=payload,
-                headers=self.headers,
-                timeout=10
-            )
-            response.raise_for_status()
-            return response.json()
-        except requests.exceptions.RequestException as e:
-            raise Exception(f"GeoEngine Error: {e}")
-
-    def create_geofence(self, name, coordinates, webhook_url):
-        """
-        Crea una geocerca.
-        coordinates debe ser una lista de listas: [[lat, lng], [lat, lng]]
-        """
-        if len(coordinates) < 3:
-            raise ValueError("Se requieren al menos 3 puntos")
-
-        # Convertir [Lat, Lng] a [Lng, Lat] para GeoJSON
-        polygon = [[p[1], p[0]] for p in coordinates]
-        
-        # Cerrar polígono
-        if polygon[0] != polygon[-1]:
-            polygon.append(polygon[0])
-
-        payload = {
-            "name": name,
-            "webhook_url": webhook_url,
-            "geojson": {
-                "type": "Polygon",
-                "coordinates": [polygon]
-            }
-        }
-
-        try:
-            response = requests.post(
-                f"{self.management_url}/geofences",
-                json=payload,
-                headers=self.headers,
-                timeout=10
-            )
-            response.raise_for_status()
-            return response.json()
-        except requests.exceptions.RequestException as e:
-            if response.content:
-                raise Exception(f"API Error: {response.json().get('error', response.text)}")
-            raise Exception(f"Connection Error: {e}")