Locations

O módulo Locations: como os CPO publicam locais, EVSE e conectores e como o MOBI.Hub os encaminha para os EMSP.

Nesta página

Considerações técnicas

Quando um CPO cria ou atualiza objetos Location, o MOBI.Hub deve encaminhar a informação para os EMSP ligados, chamando o endpoint Receiver de Locations correspondente.

Os CPO são autónomos na criação e gestão de Locations no MOBI.Hub. O MOBI.Hub deve garantir que a informação relevante é encaminhada para os EMSP com uma relação de interoperabilidade ativa.

O número de pedidos GET pode ser limitado por entidade requerente e as respostas podem ser guardadas em cache pelo MOBI.Hub.

A publicação de uma Location no MOBI.Hub fica ao critério do CPO. Qualquer Location disponibilizada através do HUB pode ser partilhada com EMSP de acordo com as relações de interoperabilidade configuradas na plataforma.

Para efeitos de OCPI, a relação entre uma Location e um posto de carregamento físico é definida pelo CPO. Um CPO pode considerar cada posto de carregamento físico como uma Location separada ou agrupar vários postos de carregamento situados no mesmo local numa única Location, sendo cada posto de carregamento representado como um EVSE_ID.

No caso dos campos OCPI opcionais, o MOBI.Hub não garante que sejam tratados e partilhados com todas as entidades.

Para as datas de atualização de uma Location, deve ser considerada a atualização mais recente de qualquer um dos EVSE subjacentes.

O MOBI.Hub deve suportar as opções date_from e date_to nos pedidos GET.

Métodos a implementar

EMSP (e MOBI.Hub)

Métodos de `Locations` para o EMSP (e MOBI.Hub)
Método	Direção	Descrição da utilização
`GET`	Pedido	Responder com o estado de um posto de carregamento
`PUT`	Resposta	Enviar a criação de um novo posto de carregamento
`PATCH`	Resposta	Atualizar o estado de um EVSE (incluindo EOL ou `REMOVED`)

CPO (e MOBI.Hub)

Métodos de `Locations` para o CPO (e MOBI.Hub)
Método	Direção	Descrição da utilização
`GET`	Resposta	Receber pedidos de partes externas
`PUT`	Pedido	Enviar a criação de um novo posto de carregamento
`PATCH`	Pedido	Atualizar o estado de um EVSE (incluindo EOL ou `REMOVED`)

O CPO tem de garantir a atualização correta do estado em tempo real.

Note-se que, para o estado UNKNOW, o CPO tem de considerar os casos em que não houve heartbeats nos últimos 5 minutos e, imediatamente a seguir, enviar um PATCH com a atualização do estado.

Definição dos objetos

Location

Só devem ser comunicadas as seguintes propriedades:

Tabela 1 – Propriedades do objeto `Location`
Propriedade	Valores	Obrigatório	Comentários
`country_code`	`PT`	TRUE	Alpha-2
`party_id`		TRUE	Códigos ISO-15118 a definir pela Mobi.e. [OPC]
`id`		TRUE	A validar e emitir pela Mobi.e de acordo com 0.
`publish`	`true` / `false`	TRUE	Consultar o parágrafo 3.4.3.4
`name`		FALSE	O CPO é livre de criar um nome representativo para o local. Os nomes serão apresentados em português.
`address`		TRUE	Rua e número de porta
`city`		TRUE	Cidade/município. Os nomes devem ser indicados em português
`country`	`PRT`	TRUE	Alpha-3. O roaming não é suportado na interface à data da Fase 1.
`postal_code`		FALSE
`state`		FALSE
`coordinates`		TRUE
`parking_type`	`ALONG_MOTORWAY` `PARKING_GARAGE` `PARKING_LOT` `ON_DRIVEWAY` `ON_STREET` `UNDERGROUND_GARAGE`	FALSE
`evses`		TRUE
`directions`		FALSE
`operator`	Apenas se o CPO existir. Caso contrário, usar um nome genérico.	TRUE
`suboperator`		FALSE
`owner`		FALSE
`facilities`	(Ver lista)	FALSE
`time_zone`	`Europe/Lisbon` `Atlantic/Azores`	TRUE
`opening_times`		FALSE
`charging_when_closed`		FALSE
`images`		FALSE
`energy_mix`		FALSE
`mobie_voltage_level`	`BTN` / `BTE` / `MT`	FALSE	Específico da Mobi.e
`mobie_access_type`	`Public` / `Private`	FALSE	Específico da Mobi.e
`mobie_cpe`		FALSE	Específico da Mobi.e
`last_updated`		TRUE

EVSE

Tabela 2 – Propriedades do objeto `EVSE`
Propriedade	Valores	Obrigatório	Comentários
`uid`		TRUE	número interno da plataforma do CPO; é aconselhável que não seja apresentado pelas aplicações
`evse_id`		TRUE	Código do país (2 caracteres) + ID do operador (3 caracteres) + tipo de ID (1 caracter) + ID único do ponto de carregamento (1 a 30 caracteres). Os separadores () são opcionais, mas recomendados para uma versão mais legível. Ex.: `PTMOB*E222999`
`Status`	`PLANNED` `AVAILABLE` [Idle] `CHARGING` `INOPERATIVE` `OUTOFORDER` [OutOfService] `RESERVED` [Reserved] `UNKNOWN` [Unknown] `REMOVED` [EndOfLife]	TRUE
`Capabilities`	`REMOTE_START_STOP_CAPABLE` `RFID_READER`	TRUE	Um CPO DEVERIA criar sempre um EVSE com as capacidades corretas (para garantir que o posto de carregamento é usado corretamente).
`Connectors`		TRUE
`Floor_level`		FALSE
`Coordinates`		FALSE
`Physical_reference`		FALSE
`Directions`		FALSE
`Parking_restrictions`		FALSE
`Images`		FALSE
`last_updated`		TRUE

Note-se que os EVSE com o estado “REMOVED” NÃO DEVEM ser apresentados pelo EMSP aos utilizadores finais.

Connector

Tabela 3 – Propriedades do objeto `Connector`
Propriedade	Valores	Obrigatório	Comentários
`id`		TRUE
`standard`	`CHADEMO` `IEC_62196_T2` `IEC_62196_T2_COMBO`	TRUE
`format`	`SOCKET` `CABLE`	TRUE
`power_type`	`AC_1_PHASE` `AC_3_PHASE` `DC`	TRUE
`max_voltage`	400 (exemplo)	TRUE	Em V
`max_amperage`	16 (exemplo)	TRUE	Em A
`max_electric_power`	22000	FALSE	Em W
`tariff_ids`		TRUE	A definir no módulo `Tariffs`
`terms_and_conditions`		TRUE	Em particular, os termos e condições devem incluir o nível de precisão da medição em DC, se aplicável.
`last_updated`		TRUE

Considerações sobre a propriedade “publish”

Quando publish é FALSE, as locations NÃO DEVEM ser apresentadas em momento algum pelo EMSP.

Os EVSE nos estados PLANNED ou REMOVED NÃO DEVEM ser apresentados em momento algum pelo EMSP, independentemente da sua propriedade publish.