# Occupation portuaire

> L'occupation d'un port est le nombre de navires actuellement dans le polygone du port, postes à quai inclus et zones d'attente exclues, divisé par le maximum historique de ce port ; l'écart à la moyenne la compare à l'occupation habituelle.

La Ports Intelligence API renvoie l'occupation d'un port — son niveau de remplissage comparé à son historique — avec les détails du port et les navires actuellement au port. Les données d'occupation couvrent un ensemble standard de plus de 720 grands ports de commerce, accessibles par défaut avec votre clé d'API. L'endpoint [`GET /ports/{unlocode}`](/fr/api/ports-intelligence/reference/get-port-details) renvoie les détails d'un port et l'occupation de ses postes à quai.

::callout{type="warning"}
La Ports Intelligence API est en bêta. Elle peut évoluer et n'est pas forcément tout à fait stable : utilisez-la avec prudence en environnement de production.
::

## Pourcentage d'occupation

L'occupation d'un port s'exprime en pourcentage : le nombre de navires actuellement dans le port, divisé par le nombre maximal de navires jamais enregistré dans ce port.

Pour un port dont le maximum historique est de 28 navires et qui accueille actuellement 15 navires :

```text
occupation = 15 / 28 = 53.57%
```

## Zone du port

Un navire est compté comme au port, et inclus dans l'occupation, quand il se trouve à l'intérieur du polygone du port.

- Le polygone du port inclut toutes les zones de postes à quai.
- Le polygone du port exclut les zones d'attente.

## Calcul des statistiques

La capacité et l'occupation de chaque port sont calculées en trois étapes :

1. Les navires présents dans le port sont comptés toutes les heures, par type de navire.
2. Les nombres moyen et maximal historiques de navires sont calculés pour chaque port.
3. Le nombre actuel de navires, issu des données en temps réel, est comparé à ces statistiques historiques pour en déduire le pourcentage d'occupation — nombre actuel rapporté au maximum — et l'écart à la moyenne.

Les données sont produites par l'équipe data science de Safecube à partir de plusieurs sources, dont les données AIS satellitaires et la liste des ports de la CEE-ONU.

## Écart à la moyenne

En plus de l'occupation actuelle, l'API donne l'écart entre l'occupation actuelle et l'occupation historique moyenne du port :

```text
gap with mean = current occupation - mean historical occupation
```

Il montre à quel point le port est plus chargé ou plus calme que d'habitude.

Pour Le Havre (`FRLEH`), avec une moyenne historique de 15 navires et un maximum historique de 28 navires :

- l'occupation moyenne est de `15 / 28 = 53.57%` ;
- avec une occupation actuelle de 80 %, l'écart à la moyenne est de `80% - 53.57% = 26.43%`.

Un écart de 26,43 % ne signifie pas que le port accueille 26,43 % de navires de plus que d'habitude : il signifie que le port est 26,43 % plus congestionné que d'habitude.

## Ports couverts

Les ports couverts par défaut sont listés ci-dessous par leur UN/LOCODE, regroupés par le code pays à deux lettres qui le commence.

::callout{type="info"}
Pour des données d'occupation sur d'autres ports, sur des zones portuaires personnalisées ou sur des types de navires hors de l'accès par défaut, [contactez l'équipe Safecube](https://app.safecube.ai/contact).
::

- **AE**: AEAUH, AEJEA, AESHJ
- **AG**: AGSJO
- **AO**: AOLAD
- **AR**: ARSFN, ARZAE
- **AS**: ASPPG
- **AU**: AUADL, AUBNE, AUDPO, AUDRW, AUFRE, AUMKY, AUNTL, AUPKL
- **AW**: AWAUA
- **BB**: BBBGI
- **BE**: BEANR, BEBGS, BEGNE, BEHEX, BEMHN, BEMRK, BEOEL, BEOST, BEWJG, BEZEE, BEZEL
- **BG**: BGBOJ, BGVAR
- **BH**: BHKBS
- **BJ**: BJCOO
- **BN**: BNMUA
- **BR**: BRPNG, BRRIG, BRRIO, BRSSA, BRSSZ, BRSUA, BRVIX
- **BS**: BSFPO, BSNAS
- **CA**: CAHAL, CANNO, CAVAN
- **CG**: CGPNR
- **CI**: CIABJ
- **CL**: CLARI, CLIQQ, CLMJS, CLPMC, CLSAI
- **CM**: CMDLA
- **CN**: CNCAN, CNHUA, CNLYG, CNNGB, CNQDG, CNSHG, CNTXG, CNXMG, CNXNA, CNZOS
- **CO**: COBUN, COCTG, COSMR
- **CR**: CRLIO
- **CW**: CWWIL
- **CY**: CYFMG, CYLCA, CYLMS, CYVAS
- **DE**: DEBKE, DEBLM, DEBMK, DEBRB, DEBRE, DEBRV, DEBUZ, DECUX, DEELS, DEEME, DEHAM, DEHGL, DEHOD, DEKEL, DEKOP, DELBC, DEMUK, DENHA, DEOSR, DERSK, DESTL, DESTS, DETRV, DEVIW, DEWIS, DEWVN
- **DJ**: DJJIB
- **DK**: DKAAL, DKAAR, DKCPH, DKEBJ, DKFDH, DKFDV, DKFRC, DKKAL, DKKOG, DKKOL, DKLIN, DKNAK, DKNBG, DKRAN, DKRNN, DKSKA, DKTHN, DKVOR, DKVRE
- **DO**: DOSDQ
- **DZ**: DZDJE
- **EC**: ECESM, ECMEC
- **EE**: EEBEK, EEKND, EEMUG, EEPAS, EEPLA, EEPLS, EERON, EESLM, EEVEB
- **EG**: EGADA, EGALY, EGEDK
- **ES**: ESAER, ESAGP, ESALC, ESALG, ESAVS, ESBCN, ESBIO, ESCAD, ESCAR, ESCAS, ESFRO, ESGAR, ESGIJ, ESHUV, ESLCG, ESLEI, ESLEO, ESMOT, ESPAS, ESPMI, ESPMN, ESRTA, ESSAG, ESSDR, ESTAR, ESVGO, ESVLC
- **FI**: FIAJO, FIHKO, FIHMN, FIKAS, FIKJO, FIKOK, FIKTK, FIKVH, FINLI, FIOUL, FIPRV, FIRAA, FIRAU, FIROY, FITKU, FIVAA, FIVSS
- **FJ**: FJSUV
- **FR**: FRBAI, FRBES, FRCQF, FRDKK, FRDON, FRFOS, FRHON, FRIRK, FRLAV, FRLEH, FRLPE, FRLRT, FRLSO, FRMRS, FRMTX, FRPDB, FRSET, FRSML, FRSNR, FRYNE
- **GA**: GALBV
- **GB**: GBABD, GBAVO, GBBEL, GBBLY, GBBOS, GBBRK, GBCOW, GBDAG, GBDVR, GBEAM, GBERI, GBFAW, GBFXT, GBGLW, GBGOO, GBGRG, GBGRK, GBGSY, GBGTY, GBHRW, GBHTP, GBHUL, GBIMM, GBIOG, GBIPS, GBKGH, GBKLN, GBKLR, GBKYL, GBLDY, GBLEI, GBLER, GBLGP, GBLIV, GBMLF, GBNFT, GBNHO, GBNPT, GBPFT, GBPHD, GBPLY, GBPME, GBPOO, GBPRU, GBPTL, GBRCS, GBRID, GBSEA, GBSFW, GBSHO, GBSHS, GBSOU, GBSSS, GBSUN, GBTEE, GBTHP, GBTIL, GBTNM, GBTRA, GBWPN, GBWPT
- **GD**: GDSTG
- **GE**: GEBUS, GEPTI
- **GH**: GHTEM
- **GI**: GIGIB
- **GM**: GMBJL
- **GN**: GNCKY
- **GP**: GPPTP
- **GQ**: GQBSG, GQSSG
- **GR**: GRAGT, GRASS, GREEU, GRGPA, GRIOS, GRJMK, GRJNX, GRJSY, GRJTR, GRKLM, GRMLO, GRNKV, GRPER
- **HR**: HRSPU
- **HT**: HTPAP
- **IE**: IERIN, IEWAT, IEWHI
- **IL**: ILASH, ILHFA
- **IN**: INBOM, INENR, INMAA, INMUN, INPAV
- **IQ**: IQUQR
- **IS**: ISAKU, ISBIL, ISGRT, ISREY
- **IT**: ITAOI, ITAUG, ITBDS, ITBRI, ITCAG, ITCTA, ITGIT, ITGOA, ITLIV, ITMDC, ITMLZ, ITMNF, ITNAP, ITOLB, ITPFX, ITPIO, ITPMO, ITPNG, ITPTO, ITRAN, ITSAL, ITSPE, ITSVN, ITTAR, ITTRS, ITVCE, ITVDL
- **JM**: JMKIN
- **JO**: JOAQJ
- **JP**: JPCHB, JPGAM, JPHHR, JPHIC, JPHIJ, JPHKT, JPHTC, JPKND, JPMOJ, JPNAN, JPNGO, JPOMZ, JPOSA, JPSAK, JPTHS, JPUKB, JPYKK, JPYOK, JPYOS
- **KE**: KEMBA
- **KN**: KNBAS
- **KR**: KRINC, KRKUV, KRMAS, KRMOK, KRPTK, KRPUS, KRUSN
- **KW**: KWMEA
- **LB**: LBBEY
- **LC**: LCCAS
- **LK**: LKHBA
- **LR**: LRMLW
- **LT**: LTKLJ
- **LV**: LVLPX, LVRIX, LVVNT
- **LY**: LYMRA
- **MA**: MACAS, MATNG
- **ME**: MEBAR
- **MG**: MGTOA
- **MH**: MHMAJ
- **MM**: MMRGN
- **MP**: MPSPN
- **MQ**: MQFDF
- **MR**: MRNKC
- **MT**: MTMLA
- **MU**: MUPLU
- **MX**: MXATM, MXLZC, MXVER
- **MY**: MYBKI, MYKCH, MYPKG
- **MZ**: MZMPM
- **NA**: NAWVB
- **NC**: NCNOU
- **NG**: NGLOS
- **NI**: NICIO
- **NL**: NLHAG, NLHAN, NLHAR, NLHAS, NLHFW, NLHRN, NLHVH, NLIJM, NLISM, NLKAI, NLKAM, NLLEY, NLLMR, NLLWR, NLMAK, NLMSL, NLMSV, NLNGV, NLNKK, NLODT, NLOGP, NLOHI, NLOVN, NLPER, NLROZ, NLRTM, NLSCI, NLSLU, NLSVG, NLTHO, NLTMZ, NLTNZ, NLTRO, NLTSL, NLURK, NLVLA, NLVLI, NLVSN, NLWAL, NLWRG, NLWSO, NLWSP, NLWTN, NLZAA, NLZBB, NLZBW, NLZWO, NLZWS, NLZWW
- **NO**: NOAES, NOAGO, NOAHM, NOALF, NOAVE, NOBGO, NOBJF, NOBNN, NOBOO, NOBTH, NOBVK, NOBVR, NODRM, NODUS, NOEGE, NOEGG, NOEKF, NOELN, NOEYD, NOFAN, NOFAU, NOFIS, NOFLO, NOFNE, NOFNN, NOFOL, NOFOR, NOFRK, NOFRO, NOFRS, NOGLO, NOHAU, NOHAV, NOHEK, NOHEY, NOHFT, NOHIT, NOHLA, NOHLE, NOHOG, NOHOL, NOHOR, NOHOT, NOHRD, NOHSA, NOHSO, NOHVG, NOHYR, NOKAR, NOKKN, NOKMO, NOKMY, NOKON, NOKOP, NOKRV, NOKSU, NOKVD, NOLAG, NOLAR, NOLKA, NOLKN, NOLNS, NOLOD, NOLOV, NOLRI, NOLSU, NOMAN, NOMAY, NOMEL, NOMJF, NOMOL, NOMON, NOMQN, NOMSD, NOMSS, NOMYR, NONSF, NONVK, NONZI, NOOLN, NOOSL, NOOSY, NOOTA, NOPOR, NORAF, NOREK, NORSH, NORVK, NORYF, NOSAG, NOSAS, NOSAT, NOSAY, NOSJH, NOSKN, NOSKX, NOSLG, NOSLV, NOSLX, NOSOR, NOSOY, NOSPG, NOSPV, NOSRP, NOSSJ, NOSTB, NOSTU, NOSVE, NOSVG, NOSVI, NOTAE, NOTAV, NOTBO, NOTOS, NOTRA, NOTRD, NOUTH, NOVAE, NOVER, NOVSM, NOVST
- **NZ**: NZAKL, NZLYT, NZNSN, NZWLG
- **OM**: OMSLL, OMSOH
- **PA**: PACTB, PAMIT
- **PE**: PECLL
- **PF**: PFPPT
- **PG**: PGLAE, PGPOM
- **PH**: PHBTG
- **PK**: PKKHI
- **PL**: PLGDN, PLGDY, PLPLC, PLSWI, PLSZZ
- **PR**: PRSJU
- **PT**: PTAVE, PTBRO, PTFDF, PTLEI, PTLIS, PTSET, PTSIE
- **RE**: REREU
- **RO**: ROAGI, ROCND, ROMED, ROMID, ROMUR, ROOVI, ROSUL
- **RU**: RUAZO, RUBLT, RUBNK, RUGDZ, RUKDT, RUKGD, RUKZP, RULED, RULOM, RUMMK, RUNVS, RUPRI, RUROV, RUTAG, RUTAM, RUTMR, RUTUA, RUULU, RUVVO, RUYEY, RUZAL
- **SA**: SAJED
- **SD**: SDPZU
- **SE**: SEAHU, SEASP, SEBRO, SEGOT, SEGVX, SEHAD, SEHAH, SEHAN, SEHEL, SEHLD, SEJAT, SEKAN, SEKLR, SELAA, SELGD, SELLA, SEMMA, SENRK, SENYN, SEOSK, SEOXE, SEROR, SESOE, SESOL, SESTE, SESTO, SEVAG, SEWAL
- **SG**: SGSIN
- **SH**: SHASI
- **SI**: SIKOP
- **SL**: SLFNA
- **SN**: SNDKR
- **SR**: SRPBM
- **SV**: SVAQJ
- **SX**: SXPHI
- **SY**: SYLTK
- **TG**: TGLFW
- **TH**: THLCH
- **TN**: TNRDS
- **TO**: TOTBU
- **TR**: TRALI, TRAMR, TRAUT, TRAYT, TRBAK, TRBDM, TRDRC, TRERE, TREYP, TRGEB, TRGEM, TRHAY, TRIDS, TRISK, TRIZM, TRKAR, TRKFZ, TRMER, TRNEM, TRPEN, TRSRK, TRSSX, TRTEK, TRTOC, TRTUZ, TRYAL, TRYAR, TRZEY, TRZON
- **TT**: TTPOS
- **TW**: TWKEL, TWTPE, TWTXG
- **UA**: UADNB, UAERD, UAILK, UAKEH, UAKHE, UAMPW, UANLV, UAOCT, UAODS, UAYUZ, UAZUR
- **US**: USBAL, USBNC, USBPT, USCHS, USDET, USDVV, USGLS, USHOU, USHVN, USILM, USJAX, USLGB, USMOB, USNTD, USNYC, USPEF, USPHL, USSAV, USSSI, USTIW
- **UY**: UYMVD
- **ZA**: ZACPT, ZADUR, ZAZBA
