Estimativa e expansão de QPS
A concorrência é medida por QPS (Queries per second), ou seja, o número de solicitações de serviço válidas recebidas pelo servidor por segundo. Independentemente de a localização ser bem-sucedida ou não, desde que a solicitação contenha o AppId correto da biblioteca de mapas de localização em nuvem e passe pela autenticação, ela será contabilizada nas estatísticas de concorrência.
Depois que o dispositivo é inicializado com sucesso, ele envia solicitações de localização por padrão com frequência de 1 vez por segundo. Devido à latência de rede e às diferenças no horário de chegada das solicitações, a concorrência instantânea pode exceder o limite de QPS. Por exemplo, 10 QPS teoricamente suportam 10 dispositivos, mas se mais de 10 solicitações forem recebidas no mesmo segundo, as solicitações excedentes serão rejeitadas. Para garantir a estabilidade do serviço em cenários com múltiplos dispositivos concorrentes, recomenda-se reservar alguma redundância ao comprar QPS. Por exemplo, para suportar 10 dispositivos, você pode configurar 11-12 QPS.
Os grupos de serviço de localização em nuvem fornecem 10 concorrências por padrão, atendendo à maioria dos cenários de aplicação. Para cenários com concorrência mais alta, também fornecemos opções flexíveis de expansão de recursos:
- Durante períodos de alta concorrência, como feriados, você pode escolher um pacote de expansão de curto prazo para aumentar temporariamente a capacidade concorrente
- Para aplicações com grande número de usuários e necessidade de suporte estável a alta concorrência, recursos concorrentes adicionais podem ser vinculados ao grupo de serviço em nuvem a longo prazo durante seu período de validade
Com base em 10 QPS, você pode escolher de forma flexível pacotes suplementares de curto prazo ou aumentar cotas fixas de concorrência a longo prazo para atender às necessidades de recursos em diferentes etapas do negócio.
Comportamento quando a concorrência excede o limite
Quando as solicitações excedem instantaneamente o QPS alocado, o serviço retorna a seguinte mensagem de erro (exemplo):
statuCode: 21, message: "Exceed your QPS limitation"
Se usuários em teste não conseguem localizar, provavelmente é por QPS insuficiente. Recomenda-se usar o Mega Toolbox para abrir os logs e verificar as mensagens de resposta, conforme mostrado:

Nota
Usuários em teste têm uma cota de concorrência relativamente pequena. Quando a localização falhar, observe se há mensagens de erro por excesso de limite.
Expansão de QPS concorrente
Você pode ampliar a cota de concorrência de duas formas:
- Consultar comercial ou atendimento ao cliente offline (adequado para necessidades de grande escala, longo prazo ou customizadas)
- Fazer upgrade diretamente online no console de gerenciamento (adequado para expansão temporária ou pequena)
Upgrade por consulta comercial offline
Quando a concorrência diária esperada exceder 50 QPS, recomenda-se entrar em contato com vendas ou atendimento ao cliente EasyAR para organizar expansão de capacidade e garantia de recursos. Após a expansão, faça login no backend de desenvolvedor para confirmar se a cota entrou em vigor.
O processo de confirmação da cota de concorrência é mostrado no quadro abaixo:
Etapas de operação:
- Developer Center -> Block Cloud Localization -> Grupo de serviço de localização em nuvem -> Current QPS

Recomenda-se confirmar a quantidade de QPS após o upgrade e o período de validade. Você pode visualizar isso na interface de gerenciamento EasyAR. A próxima seção apresenta a operação: Gerenciamento de QPS concorrente
Upgrade online
O console oferece duas entradas para upgrade online de QPS, conforme mostrado:
Developer Center -> Block Cloud Localization -> Grupo de serviço de localização em nuvem -> Upgrade
Developer Center -> Block Cloud Localization -> Grupo de serviço de localização em nuvem -> QPS details -> Upgrade

Importante
Para necessidades de grande concorrência acima de 50 QPS, ainda é necessário consultar o comercial para garantir fornecimento estável de recursos.
Gerenciar QPS concorrente
O gerenciamento de concorrência inclui principalmente:
- Visualizar a quantidade atual de QPS
- Expansão de QPS
- Upgrade do período de validade de parte do QPS
Interface de gerenciamento
Etapas de operação
- Faça login no Developer Center -> Block Cloud Localization -> Grupo de serviço de localização em nuvem -> QPS details
Upgrade da quantidade de QPS e período de validade

Após entrar em QPS details, a interface é mostrada como na imagem acima. A quantidade atual de QPS aparece no quadro à direita da imagem.
A linha do tempo no centro da interface mostra os períodos de validade da parte QPS básica e da parte QPS atualizada.
Os registros de compra na parte inferior mostram os pedidos de upgrade e detalhes do período de validade.
Recomendações
- Estime a concorrência de pico esperada em vez da concorrência média e reserve redundância para o pico (por exemplo, para pico de 10 QPS, recomenda-se comprar 11-12 QPS).
- Durante feriados ou eventos, você pode comprar temporariamente pacotes suplementares de curto prazo para atender a necessidades de alta concorrência.
- Verificação após expansão: use Mega Toolbox em cenários de alta concorrência para confirmar que as solicitações não são rejeitadas e que as respostas são estáveis.
- Se houver rejeições contínuas ou exceções, colete logs e entre em contato com a equipe de suporte para investigação, incluindo janela de tempo, AppId da biblioteca de mapas de localização em nuvem e, preferencialmente, arquivos de captura de pacotes contendo exemplos de solicitações e códigos de erro.