Table of Contents

Qps stima e espansione

La concorrenza viene misurata in QPS (Queries per second), ovvero il numero effettivo di richieste di servizio ricevute dal server ogni secondo. Indipendentemente dal successo del posizionamento, qualsiasi richiesta contenente il corretto AppId della libreria cloud e autenticata verrà conteggiata nelle statistiche di concorrenza.

Dopo l'inizializzazione, il dispositivo invia richieste di posizionamento a una frequenza predefinita di 1 al secondo. A causa delle differenze nella latenza di rete e nei tempi di arrivo delle richieste, potrebbero verificarsi picchi istantanei che superano il limite QPS. Ad esempio, 10 QPS supportano teoricamente 10 dispositivi, ma se vengono ricevute più di 10 richieste nello stesso secondo, quelle in eccesso verranno rifiutate. Per garantire la stabilità del servizio in scenari multi-dispositivo ad alta concorrenza, si consiglia di prevedere un margine di ridondanza nell'acquisto dei QPS. Ad esempio, per supportare 10 dispositivi, potresti configurare 11–12 QPS.

Il gruppo di servizi cloud di posizionamento fornisce per impostazione predefinita 10 concorrenze, sufficienti per la maggior parte dei casi d'uso. Per scenari che richiedono una concorrenza più elevata, offriamo soluzioni flessibili di espansione delle risorse:

  • Durante periodi ad alta concorrenza come festività, è possibile scegliere pacchetti di espansione temporanei per aumentare temporaneamente la capacità
  • Per applicazioni con un ampio numero di utenti che necessitano di supporto stabile ad alta concorrenza, è possibile associare risorse di concorrenza aggiuntive per l'intera durata di validità del gruppo di servizi cloud

Sulla base dei 10 QPS, puoi scegliere flessibilmente pacchetti integrativi a breve termine o aumentare stabilmente la quota di concorrenza per adattarti alle esigenze delle diverse fasi aziendali.

Comportamento in caso di superamento del limite di concorrenza

Quando una richiesta supera istantaneamente i QPS allocati, il servizio restituirà il seguente messaggio di errore (esempio):

statuCode: 21, message: "Exceed your QPS limitation"

Gli utenti in stato di prova potrebbero non riuscire a posizionarsi a causa di QPS insufficienti. Si consiglia di utilizzare Mega Toolbox per aprire i log e visualizzare i messaggi di risposta. Come mostrato:

qps-limit

Nota

Gli utenti in prova hanno una quota di concorrenza ridotta. In caso di problemi di posizionamento, si consiglia di verificare la presenza di messaggi di errore relativi al superamento del limite.

Espansione della concorrenza QPS

È possibile aumentare la quota di concorrenza attraverso due modalità:

  • Consultazione offline con il reparto commerciale o l'assistenza clienti (adatto per esigenze su larga scala, a lungo termine o personalizzate)
  • Aggiornamento diretto tramite la console di gestione online (adatto per espansioni temporanee o di modesta entità)

Aggiornamento tramite consultazione commerciale offline

Quando si prevede una concorrenza giornaliera superiore a 50 QPS, si consiglia di contattare il reparto vendite o l'assistenza clienti di EasyAR per organizzare l'espansione della capacità e la garanzia delle risorse. Dopo l'espansione, accedi al developer backend per confermare l'attivazione della quota.

La procedura per confermare la quota di concorrenza è evidenziata nel riquadro della figura seguente:

Procedure operative:

  • Centro di sviluppo -> Block cloud positioning (Posizionamento cloud) -> Gruppo di servizi di posizionamento cloud -> QPS corrente

check-qps

Si consiglia di verificare il numero di QPS dopo l'aggiornamento e la data di scadenza. Puoi visualizzarlo tramite l'interfaccia di gestione di EasyAR, come spiegato nella sezione successiva: Gestione della concorrenza QPS

Aggiornamento online

La console offre due punti di accesso per l'aggiornamento online dei QPS, come mostrato:

  1. Centro di sviluppo -> Block cloud positioning (Posizionamento cloud) -> Gruppo di servizi di posizionamento cloud -> Aggiorna (Upgrade)

  2. Centro di sviluppo -> Block cloud positioning (Posizionamento cloud) -> Gruppo di servizi di posizionamento cloud -> Dettagli QPS -> Aggiorna (Upgrade)

add-qps

Importante

Per esigenze di concorrenza elevata superiori a 50 QPS, è comunque necessario consultare il reparto commerciale per garantire la stabilità della fornitura delle risorse.

Gestione della concorrenza QPS

La gestione della concorrenza include principalmente:

  • Visualizzazione del numero corrente di QPS
  • Espansione dei QPS
  • Estensione della validità di una parte dei QPS

Interfaccia di gestione

Procedure operative

  • Accedi al Centro di sviluppo -> Block cloud positioning (Posizionamento cloud) -> Gruppo di servizi di posizionamento cloud -> Dettagli QPS

Aggiornamento del numero e della validità dei QPS

qps-manage

    Accedendo ai Dettagli QPS, l'interfaccia appare come sopra. Il numero corrente di QPS è mostrato nel riquadro contrassegnato a destra.

    La linea temporale al centro mostra il periodo di validità della parte base dei QPS e della parte aggiornata.

    In fondo, il registro degli acquisti mostra i dettagli degli ordini di aggiornamento e della validità.

Consigli

  • Calcola la concorrenza di picco prevista, non quella media, e prevedi un margine di ridondanza per i picchi (ad esempio, per un picco di 10 QPS si consiglia di acquistare 11–12 QPS).
  • Durante festività o eventi è possibile acquistare temporaneamente pacchetti integrativi a breve termine per soddisfare esigenze ad alta concorrenza.
  • Verifica post-espansione: utilizza Mega Toolbox in scenari ad alta concorrenza per confermare che le richieste non vengano rifiutate e che le risposte siano stabili.
  • In caso di rifiuti persistenti o anomalie, raccogli i log e contatta il team di supporto per l'analisi (includendo finestra temporale, AppId della libreria cloud, e si consiglia di fornire file di cattura contenenti esempi di richieste e codici di errore).

Leggi il prossimo argomento

Altre spiegazioni su espansione e quote dei servizi Mega