Com o Maven e o Java instalados na sua máquina faça:

mvn clean package
java -jar target/localidade-0.0.1-SNAPSHOT.jar

Vá para http://localhost:8080/swagger-ui.html para testar os endpoints:

Esse endpoint irá retornar os ids indicados pelo nomeCidade (é possível existir cidades de mesmo nome em estados diferentes). As respostas são armazenas em cache que é reiniciado a cada minuto.

Esse endpoint irá retornar dados de todos os municípios de acordo com a documentação. Os valores aceitos para o {retorno} são json e csv. Caso haja timeout de 15 seg uma lista vazia é retornada.