Extremos síncronos y asíncronos

La API de Route Optimization expone dos métodos:

• OptimizeTours es un método síncrono que muestra una ruta optimizada en respuesta a un OptimizeToursRequest. Los clientes deben mantener una conexión abierta a la API de Route Optimization hasta que se procese la solicitud y se devuelva un OptimizeToursResponse o un error.
• BatchOptimizeTours es un método asíncrono que acepta URIs para uno o más OptimizeToursRequest y los mensajes OptimizeToursResponse correspondientes, y muestra el nombre del recurso de una operación de larga duración (LRO) (REST, gRPC) que se usa para verificar la finalización de un lote. Los OptimizeToursRequest se procesan en segundo plano, por lo que los clientes mantienen una conexión abierta a la API de Route Optimization solo el tiempo suficiente para enviar el BatchOptimizeToursRequest o llamar a GetOperation para verificar el estado de la LRO. BatchOptimizeTours lee solicitudes y escribe respuestas en Google Cloud Storage.

Casos de uso

OptimizeTours es conveniente para resolver solicitudes pequeñas y simples, o para solicitudes con tiempos de resolución de unos minutos o menos. Mantener conexiones duraderas con la API de Route Optimization aumenta el riesgo de interrupción antes de que se pueda mostrar una solución.

BatchOptimizeTours puede manejar solicitudes más grandes y solicitudes con un tiempo de resolución más prolongado, ya que no requiere una conexión de larga duración a la API de Route Optimization.

Operaciones de larga duración

Los LRO se leen de la API de Route Optimization con el método GetOperation para verificar el estado de finalización de un lote. Las LRO incluyen una propiedad done que indica si se completó el procesamiento de todo el lote y un campo error que informa los errores encontrados durante el procesamiento. Si done es verdadero y no hay error, el lote se completó correctamente. La presencia de un error indica que el procesamiento de algunos o todos los lotes falló.

Nota: Las respuestas GetOperation de REST omiten la propiedad done si su valor es falso y la propiedad error si no se produjo ningún error.

El ciclo de vida típico de una solicitud BatchOptimizeTours es el siguiente:

1. Envía un BatchOptimizeToursRequest a la API de Route Optimization, que muestra el nombre del recurso de una LRO.
2. Consulta GetOperation con el nombre del recurso de la LRO que se muestra hasta que las propiedades done o error aparezcan en la respuesta de la LRO.
3. Si done es verdadero y no hay errores, lee OptimizeToursResponses de los URIs de Google Cloud Storage especificados en la solicitud BatchOptimizeTours. Si error está presente, inspecciona el error, actualiza los OptimizeToursRequest según corresponda en Google Cloud Storage y vuelve a intentarlo según corresponda según el error observado.

Puedes enviar solicitudes de OptimizeTours y BatchOptimizeTours de varias maneras, ya sea desde la línea de comandos o con una biblioteca cliente.

Siguiente: Realiza una solicitud a la API