Calcular peajes con Gemini: function calling y apps con Google AI

Respuesta directa: no existe un conector nativo de Gemini para la API de peajes de Tolls Calculator. La forma real de calcular peajes con Gemini es function calling (Google lo llama declarative tools en la API de Gemini): declaras una herramienta con los parámetros del endpoint de peajes, y tu aplicación ejecuta la HTTP call real y devuelve el resultado al modelo. Si usas MCP, ver MCP de peajes: es el patrón que funciona igual en varios clientes.

Patrón con la API de Gemini

1. Declara la herramienta en la petición generateContent:

{
  "name": "calcular_peajes",
  "description": "Calcula el coste de peaje de una ruta para un vehículo dado. Úsala SIEMPRE que el usuario pregunte por un precio de peaje; nunca lo estimes sin consultar la herramienta.",
  "parameters": {
    "type": "OBJECT",
    "properties": {
      "polyline": { "type": "STRING", "description": "Polilínea codificada de la ruta" },
      "vehicle_class": { "type": "STRING", "enum": ["CLASS_1", "CLASS_2", "CLASS_3", "CLASS_4"] },
      "payment_method": { "type": "STRING", "enum": ["VIA_T", "TELEPASS", "CASH", "CARD"] }
    },
    "required": ["polyline", "vehicle_class"]
  }
}

1. Cuando Gemini devuelva un functionCall, tu backend llama a POST https://back.transcend.cargoffer.com/api/v1/tolls/calculate con Authorization: Bearer <API_KEY> (la clave nunca se expone al modelo).
2. Devuelve el JSON de respuesta como functionResponse y deja que Gemini redacte el resumen para el usuario.

Consejos específicos de Gemini

• Obliga a la herramienta en las instrucciones: los modelos de Google responden bien a la orden «usa la herramienta para cualquier cifra, no la estimes». Sin eso, Gemini puede citar tarifas antiguas.
• No esperes geometría de ruta: Gemini no produce polilíneas fiables. O el usuario da coordenadas que reenvías al endpoint de costes con waypoints, o tu sistema calcula antes la ruta con tu enrutador.
• Configuraciones de seguridad: si activas settings de ejecución en la API de Gemini, revisa el aislamiento de red de tu backend antes de correr código cerca de credenciales; la vía segura es la llamada tradicional desde tu servidor.
• Verifica el estado del soporte MCP en Gemini: Google ha anunciado direcciones MCP en sus productos, pero disponibilidad y nombre de la función cambian; comprueba la documentación de Google antes de prometerlo. En cualquier caso, function calling funciona hoy de forma estable.

Comparación rápida con otras vías

| Vía | Quién ejecuta la llamada | Dónde vive la API key | Disponibilidad | |---|---|---|---| | Gemini function calling | Tu app | Tu backend | Estable, documentada | | GPT con Acciones (ChatGPT) | La plataforma OpenAI | Config de la Acción | Depende del plan | | MCP (Cursor, Claude) | El cliente MCP con tu servidor local | Variable de entorno local | Estándar abierto |

Para el equivalente en ChatGPT, ver calcular peajes con ChatGPT; para Claude, skill de Claude para calcular peajes.

Aviso: ninguna cifra de peaje debe salir de un LLM sin consulta en vivo a la API; los importes de esta página son ilustrativos.