Codifica dell'URL

Alcuni caratteri non possono far parte di un URL (ad esempio lo spazio) e altri hanno un significato speciale in un URL. Nei moduli HTML, il carattere = viene utilizzato per separare un nome da un valore. La sintassi generica dell'URI utilizza la codifica dell'URL per risolvere questo problema, mentre i moduli HTML effettuano alcune sostituzioni aggiuntive piuttosto che applicare la codifica percentuale per tutti questi caratteri.

Ad esempio, gli spazi in una stringa vengono codificati con %20 o sostituiti con il segno più (+). Se utilizzi una barra verticale (|) come separatore, assicurati di codificarla come %7C. Una virgola in una stringa deve essere codificata come %2C.

Ti consigliamo di utilizzare le normali librerie per la creazione di URL della tua piattaforma per codificare automaticamente gli URL e assicurarti che contengano i caratteri di escape corretti per la tua piattaforma.

Creazione di un URL valido

Puoi pensare che un URL "valido" sia ovvio, ma non è esattamente così. Un URL inserito all'interno di una barra degli indirizzi di un browser, ad esempio, potrebbe contenere caratteri speciali (ad es. "上海+中國"); il browser deve tradurre internamente questi caratteri in una codifica diversa prima della trasmissione. Per lo stesso token, qualsiasi codice che genera o accetta input UTF-8 potrebbe considerare gli URL con caratteri UTF-8 come "validi", ma dovrebbe anche tradurli prima di inviarli a un server web. Questa procedura è chiamata codifica degli URL o codifica percentuale.

Caratteri speciali

Dobbiamo tradurre i caratteri speciali perché tutti gli URL devono essere conformi alla sintassi specificata dalla specifica URI (Uniform Resource Identifier). Ciò significa che gli URL devono contenere solo un sottoinsieme speciale di caratteri ASCII, ovvero i normali simboli alfanumerici e alcuni caratteri riservati da utilizzare come caratteri di controllo negli URL. Questa tabella riassume questi caratteri:

Riepilogo dei caratteri validi per gli URL
ImpostacaratteriUtilizzo degli URL
Alfanumerico a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Stringhe di testo, utilizzo dello schema (http), porta (8080) e così via.
Non prenotato - _ . ~ Stringhe di testo
Riservata ! * ' ( ) ; : @ & = + $ , / ? % # [ ] Caratteri di controllo e/o stringhe di testo

Quando crei un URL valido, devi assicurarti che contenga solo i caratteri mostrati nella tabella Riepilogo dei caratteri URL validi. La conformità di un URL per utilizzare questo insieme di caratteri generalmente causa due problemi, uno di omissione e uno di sostituzione:

  • I caratteri che vuoi gestire esistono al di fuori del set precedente. Ad esempio, i caratteri in lingue straniere come 上海+中國 devono essere codificati utilizzando i caratteri precedenti. Secondo una convenzione più comune, gli spazi (non consentiti all'interno degli URL) sono spesso rappresentati utilizzando anche il carattere più '+'.
  • Questi caratteri esistono all'interno del set precedente come caratteri riservati, ma devono essere utilizzati letteralmente. Ad esempio, ? viene utilizzato all'interno degli URL per indicare l'inizio della stringa di query; se vuoi utilizzare la stringa "? e i Mysterions", devi codificare il carattere '?'.

Tutti i caratteri da codificare nell'URL vengono codificati utilizzando un carattere '%' e un valore esadecimale a due caratteri corrispondente al relativo carattere UTF-8. Ad esempio, 上海+中國 in UTF-8 verrebbe codificato nell'URL come %E4%B8%8A%E6%B5%B7%2B%E4%B8%AD%E5%9C%8B. La stringa ? and the Mysterians verrebbe codificata come URL come %3F+and+the+Mysterians o %3F%20and%20the%20Mysterians.

Caratteri comuni che richiedono la codifica

Ecco alcuni caratteri comuni che devono essere codificati:

Carattere non sicuro Valore codificato
Spazio %20
" %22
< %3C
> %3E
# %23
% %25
| %7C

La conversione di un URL che ricevi dall'input utente a volte è complessa. Ad esempio, un utente può inserire un indirizzo come "Via Roma". In genere, devi creare l'URL a partire dalle sue parti, trattando gli input utente come caratteri letterali.

Inoltre, gli URL possono avere una lunghezza massima di 16.384 caratteri per tutti i servizi web e le API web statiche di Google Maps Platform. Per la maggior parte dei servizi, questo limite di caratteri verrà affrontato raramente. Tuttavia, alcuni servizi hanno diversi parametri che possono generare URL lunghi.