Como a Mantan obtém os preços oficiais de 89 países e territórios

Cada preço mostrado pela Mantan vem de uma fonte pública: um Estado que publica os preços dos postos, um Estado que fixa ele próprio o preço, ou o leitor, quando fotografa um painel de preços. A 1 de novembro de 2026, são 89 países e territórios com preços, e 173 onde o mapa mostra pelo menos os postos.

Eis como cada tipo de fonte chega ao mapa, com três histórias verdadeiras da semana passada.

Os países que publicam tudo, posto a posto

Em França, a lei obriga cada posto a declarar os seus preços. O Ministério da Economia publica-os em dados abertos em prix-carburants.gouv.fr. A Mantan descarrega esse ficheiro a cada 10 minutos: quase 10 000 postos, cada um com a hora da última mudança de preço.

Espanha publica o mesmo em JSON de hora a hora, Baleares e Canárias incluídas (11 198 postos com preço do gasóleo esta manhã). Portugal, através da DGEG, o Reino Unido, a Eslovénia, a Dinamarca, a Islândia, o México, o Chile, o Peru, o Quebeque, a Austrália Ocidental e a Nova Gales do Sul também têm ficheiros ou API oficiais.

Por vezes estas fontes falham. A 21 de outubro, todo o prix-carburants.gouv.fr respondia com um erro 502. O ficheiro diário, com os preços da véspera, continuava a funcionar: a Mantan guarda-o como reserva, e o mapa de França manteve-se cheio.

Itália trouxe outro problema. Desde 17 de outubro, o site do ministério italiano não está acessível fora de Itália. O servidor da app oficial «Osservaprezzi carburanti», esse, continua a responder: a Mantan consulta-o região a região, 20 pedidos para o país inteiro, e obtém cerca de 21 600 postos com a hora de cada declaração.

Os preços máximos: um teto, igual em todo o lado

Na Bélgica, no Luxemburgo, na Polónia, na Chéquia ou no Uruguai, o Estado publica um preço máximo. Os postos podem vender mais barato, nunca mais caro. A Mantan aplica esse teto a cada posto do país e di-lo claramente na ficha: é um máximo fixado pelo Estado, e um posto pode vender abaixo dele.

Na Chéquia, o Ministério das Finanças publica o teto todos os dias num boletim em PDF. A Mantan lê o PDF e retira o preço do mapa se nenhum boletim estiver em vigor há 3 dias.

Os preços fixados pelo Estado: 58 países copiados da fonte

Em boa parte de África, do Médio Oriente e das ilhas, o preço é igual em todos os postos porque é o Estado que o decide. A Mantan acompanha 58 destes países. Para cada um, lê a decisão oficial: um comunicado, um decreto, um PDF mensal, um despacho de agência.

Quando não é possível uma leitura automática, o preço é introduzido à mão, com a data da decisão e a ligação para o texto. O Iraque é um exemplo: os sites do Ministério do Petróleo passam por um CAPTCHA, por isso os preços (850 dinares o litro de Premium 95, 1250 dinares o Super 98) são copiados da decisão do Conselho de Ministros e verificados de novo a cada 3 meses. Ao fim de 6 meses sem verificação, um alerta pede para reler a fonte.

As fontes mudam de forma sem aviso. Na Zâmbia, o comunicado de novembro, publicado a 31 de outubro, é uma digitalização sem texto. A Mantan lê em vez disso a estrutura mensal do preço na bomba, um PDF com texto do mesmo regulador: 34,45 kwachas o litro de gasóleo a partir de 1 de novembro, o mesmo valor do comunicado digitalizado.

Camboja: algarismos khmer lidos duas vezes

O Ministério do Comércio do Camboja fixa o preço da gasolina e do gasóleo a cada 10 dias. O aviso só existe em imagem, publicada no seu canal público do Telegram, com os preços em algarismos khmer. Numa imagem com 571 píxeis de largura, um algarismo tem 6 píxeis de altura, e ៥ (5), ៩ (9) e ៨ (8) parecem-se muito.

A Mantan amplia a imagem e manda-a ler duas vezes por um programa de leitura de imagens. As duas leituras têm de dar exatamente os mesmos algarismos. Depois, o preço é confirmado três vezes, porque o aviso escreve-o três vezes:

• na frase do aviso, em riels;
• na tabela, em riels;
• na tabela, em dólares, a multiplicar pela taxa oficial impressa em baixo (4072 riels por dólar).

O preço em dólares convertido tem de ficar a 75 riels ou menos do preço em riels. Basta um algarismo mal lido num dos três números e o aviso é posto de lado. No mapa fica então o último preço validado, com a sua data. Resultado para o período de 21 de outubro a 1 de novembro: 5050 riels o litro de gasolina 92 e 5550 riels o gasóleo, em cerca de 1650 postos.

O mesmo método lê os cartazes das Honduras e do Panamá, os da Palestina e a tabela desenhada do prefeito de Maiote.

Os postos: OpenStreetMap, e um plano B

Um preço fixado pelo Estado não diz onde ficam os postos. A Mantan vai buscá-los ao OpenStreetMap, o mapa livre mantido por voluntários, e recarrega cada país todas as semanas através do serviço Overpass.

A 31 de outubro, o Overpass foi abaixo: o servidor principal recusava ligações, um espelho respondia com um erro, outro servia uma cópia de junho. Os países ligados nesse dia, entre eles o Camboja e a Nicarágua, não tinham nenhum posto.

A Mantan já sabe seguir outro caminho: os extratos da Geofabrik, uma cópia completa do OpenStreetMap recortada por país. Teste real na Nicarágua: um ficheiro de 62 MB, 287 postos, 87 deles no círculo de Manágua. São os mesmos postos, nas mesmas posições, que o Overpass devolveu quando voltou, por volta das 19h.

O leitor: a foto do painel

Nos países onde nada é publicado, o mapa mostra os postos a cinzento com esta mensagem: «Neste país os preços não são publicados. Se passar à frente, uma foto do painel torná-los-á visíveis para todos.» A foto é lida, cada preço plausível aparece como «não verificado» e desaparece sozinho assim que a fonte oficial publica algo mais recente. A foto do painel é guardada durante alguns dias para moderação.

O talão de compra segue uma regra mais estrita, porque mostra muitas vezes os últimos algarismos do cartão. A Mantan lê-o para preencher o seu registo de abastecimentos e apaga-o logo a seguir, sem nunca o guardar.

O que vê na ficha

Cada ficha de posto diz que tipo de preço mostra e de quando é: preço declarado pelo posto, preço máximo oficial, preço fixado pelo Estado ou leitura de um utilizador marcada «não verificado». Cada fonte é citada no site, com o organismo que a publica.

Quer saber de onde vem o preço do seu posto? Abra mantan.app e toque nele: o tipo de preço e a data estão na ficha.