Estimación y ampliación de QPS
La concurrencia se mide con QPS (Queries per second), es decir, el número de solicitudes de servicio válidas recibidas por el servidor por segundo. Independientemente de si la localización tiene éxito, siempre que la solicitud lleve el AppId correcto de la biblioteca de mapas de localización en la nube y pase la autenticación, se cuenta en las estadísticas de concurrencia.
Después de que un dispositivo se inicializa correctamente, envía solicitudes de localización de forma predeterminada con una frecuencia de 1 vez por segundo. Debido a la latencia de red y las diferencias en el tiempo de llegada de las solicitudes, la concurrencia instantánea puede superar el límite de QPS. Por ejemplo, 10 QPS teóricamente pueden admitir 10 dispositivos, pero si se reciben más de 10 solicitudes en el mismo segundo, las solicitudes excedentes serán rechazadas. Para garantizar la estabilidad del servicio en escenarios concurrentes con varios dispositivos, se recomienda reservar cierta redundancia al comprar QPS. Por ejemplo, para admitir 10 dispositivos, puede configurar 11-12 QPS.
Los grupos de servicio de localización en la nube proporcionan 10 solicitudes concurrentes de forma predeterminada, lo que cubre la mayoría de escenarios de aplicación. Para escenarios de mayor concurrencia, también ofrecemos opciones flexibles de ampliación de recursos:
- Durante periodos de alta concurrencia, como festivos, puede elegir un paquete de ampliación a corto plazo para aumentar temporalmente la capacidad concurrente
- Para aplicaciones con muchos usuarios que requieren soporte estable de alta concurrencia, se pueden vincular recursos concurrentes adicionales al grupo de servicio en la nube a largo plazo dentro de su periodo de validez
Sobre la base de 10 QPS, puede elegir de forma flexible paquetes complementarios a corto plazo o aumentar cuotas fijas de concurrencia a largo plazo para adaptarse a las necesidades de recursos en distintas etapas del negocio.
Comportamiento al superar el límite de concurrencia
Cuando las solicitudes superan instantáneamente el QPS asignado, el servicio devuelve el siguiente mensaje de error (ejemplo):
statuCode: 21, message: "Exceed your QPS limitation"
Si los usuarios en estado de prueba no pueden localizar, probablemente se deba a QPS insuficiente. Se recomienda abrir los logs con Mega Toolbox y revisar los mensajes de respuesta, como se muestra:

Nota
La cuota de concurrencia para usuarios de prueba es relativamente pequeña. Cuando no se puede localizar, preste más atención a si hay mensajes de error por exceso de límite.
Ampliación de QPS concurrente
Puede ampliar la cuota de concurrencia de dos maneras:
- Consultar offline con ventas o atención al cliente (adecuado para necesidades a gran escala, a largo plazo o personalizadas)
- Actualizar directamente online en la consola de gestión (adecuado para ampliación temporal o pequeña)
Actualización mediante consulta comercial offline
Cuando la concurrencia diaria esperada supera 50 QPS, se recomienda contactar con ventas o atención al cliente de EasyAR para organizar la ampliación de capacidad y la garantía de recursos. Después de la ampliación, inicie sesión en el backend de desarrollador para confirmar si la cuota ha entrado en vigor.
El proceso para confirmar la cuota de concurrencia se muestra en el recuadro siguiente:
Pasos de operación:
- Developer Center -> Block Cloud Localization -> Grupo de servicio de localización en la nube -> Current QPS

Se recomienda confirmar la cantidad de QPS después de la actualización y el periodo de validez. Puede verlo en la interfaz de gestión de EasyAR. La siguiente sección presenta la operación: Gestión de QPS concurrente
Actualización online
La consola ofrece dos entradas para actualizar QPS online, como se muestra:
Developer Center -> Block Cloud Localization -> Grupo de servicio de localización en la nube -> Upgrade
Developer Center -> Block Cloud Localization -> Grupo de servicio de localización en la nube -> QPS details -> Upgrade

Importante
Para necesidades de gran concurrencia superiores a 50 QPS, sigue siendo necesario consultar con ventas para garantizar un suministro estable de recursos.
Gestionar QPS concurrente
La gestión de concurrencia incluye principalmente:
- Ver la cantidad actual de QPS
- Ampliación de QPS
- Actualizar el periodo de validez de parte del QPS
Interfaz de gestión
Pasos de operación
- Inicie sesión en Developer Center -> Block Cloud Localization -> Grupo de servicio de localización en la nube -> QPS details
Actualizar cantidad de QPS y periodo de validez

Después de entrar en QPS details, la interfaz se muestra como en la imagen anterior. La cantidad actual de QPS aparece en el recuadro derecho de la imagen.
La línea de tiempo en el centro de la interfaz muestra los periodos de validez de la parte base de QPS y de la parte QPS actualizada.
Los registros de compra en la parte inferior muestran las órdenes de actualización y los detalles del periodo de validez.
Recomendaciones
- Estime la concurrencia pico esperada en lugar de la concurrencia media, y reserve redundancia para el pico (por ejemplo, para un pico de 10 QPS se recomienda comprar 11-12 QPS).
- Durante festivos o eventos, puede comprar temporalmente paquetes complementarios a corto plazo para satisfacer necesidades de alta concurrencia.
- Verificación después de la ampliación: use Mega Toolbox en escenarios de alta concurrencia para confirmar que las solicitudes no sean rechazadas y que las respuestas sean estables.
- Si encuentra rechazos continuos o excepciones, recopile logs y contacte con el equipo de soporte para diagnóstico, incluyendo la ventana temporal, el AppId de la biblioteca de mapas de localización en la nube, y preferiblemente archivos de captura de paquetes con ejemplos de solicitudes y códigos de error.