truck parking APIPOI API Europerest areas API

Documentar `/poi` (parkings, talleres, áreas de descanso)

Mega-Tutorial: Localizador de Puntos de Interés (POI) Logísticos Especializados

En el mundo B2C, un restaurante puede buscarse en Google. En el B2B logístico, el conductor necesita saber si ese restaurante tiene un aparcamiento de 18 metros vigilado, duchas gratuitas y un lavadero industrial. TRANSCEND POI API es el motor de búsqueda geográfico más completo para el chófer profesional.

1. Visión Arquitectónica

La API filtra y localiza:

  • Parkings Seguros (TAPA/SSTPA): Prevención de robos de mercancía valiosa.
  • Duchas y Áreas de Descanso: Para el bienestar del conductor y cumplimiento de pausas del tacógrafo.
  • Talleres Oficiales: Neumáticos, lunas, lonas y mecánica pesada, filtrables por marca de tractora (Volvo, Scania, Mercedes).
  • Estaciones con AdBlue / GNL / GNC: Puntos de repostaje especializado.

2. Especificación Técnica Completa (OpenAPI)

El sistema soporta queries espaciales y radiales muy complejas.

GET https://api.cargoffer.com/pois/search

Parámetros Query

  • lat / lng: Centro de búsqueda (WGS84).
  • radius_km: Radio de búsqueda (ej. 50).
  • type: secure_parking, workshop, shower, fuel.
  • amenities: Array CSV de requerimientos (ej. adblue,restaurant,wifi).

Ejemplo cURL

curl -G "https://api.cargoffer.com/pois/search" \
     -H "Authorization: Bearer TU_API_KEY" \
     --data-urlencode "lat=41.38" \
     --data-urlencode "lng=2.17" \
     --data-urlencode "radius_km=25" \
     --data-urlencode "type=secure_parking" \
     --data-urlencode "amenities=shower,cctv"

JSON Response

{
  "results": [
    {
      "id": "POI-P-992",
      "name": "Truck Park AP-7 La Jonquera",
      "location": { "lat": 42.41, "lng": 2.87 },
      "distance_km": 12.4,
      "details": {
        "capacity": 200,
        "available_spots": 45,
        "security": ["cctv", "fenced", "guards_24_7", "tapa_level_1"],
        "price_per_hour": 1.50
      },
      "amenities": ["shower", "restaurant", "wifi", "laundry"]
    }
  ]
}

3. Integración Directa vía Servidor MCP

La IA puede funcionar como un copiloto virtual para el conductor utilizando MCP.

Instalación

npx -y @cargoffer/mcp-server-transcend@latest

Tools Expuestas

  • find_nearby_truck_parking: Localiza parkings seguros.
  • find_nearby_amenities: Encuentra duchas, restaurantes o talleres cerca de las coordenadas del camión.

4. Patrones de Prompting (System Prompts)

System Prompt Sugerido: "Eres un Copiloto IA para Conductores de Camión. Cuando un usuario indique que 'se le acaba el tiempo de disco/tacógrafo', debes obtener su posición actual e invocar inmediatamente la tool find_nearby_truck_parking con un radio menor a 20 km. Prioriza siempre los resultados que contengan security: tapa_level_1 si llevan mercancía valiosa."

5. Siguientes Pasos y Tutoriales Relacionados

Explora cómo combinar esta funcionalidad con otros módulos de TRANSCEND para crear flujos de trabajo avanzados en tu LLM o Agente: