Livro 4 - Projeto da Previsão do Tempo

4. Configurações iniciais

4.1. Recurso strings.xml

Para o aplicativo vamos precisar dos seguintes recursos strings:

Nome do recurso

Valor

api_key

Escolha sua chave pessoal ou use: 7c0cffe2e25bc681909553be76d060c0

web_service_url

https://api.openweathermap.org/data/2.5/forecast?q=

invalid_url

A URL digitada é inválida.

weather_condition_image

Uma representação gráfica das condições climáticas.

high_temp

Máxima: %s

low_temp

Mínima: %s

day_description

%1$s: %2$s

humidity

Umidade: %s

hint_text

Digite uma cidade (ex: Jaraguá do Sul, SC)

read_error

Não foi possível ler os dados da previsão do tempo.

connect_error

Não foi possível se conectar a OpenWeatherMap.org

Na primeira linha da tabela vemos a definição da chave de API a nível de código. Você pode definir uma chave de acesso de sua conta pessoal do OpenWeatherApp ou usar a disponibilizada na tabela. Na segunda linha vemos uma boa prática de programação para definir um recurso para o endereço da API de modo que a programação nunca faça acesso direto a URL mas haja por intermeio desta variável. Isso possibilita a migração da API no futuro de modo que não impacte a programação em si. Nas próximas linhas existem alguns mensagens de erros que serão mostradas na Snackbar em caso de falhas na comunicação com a API, essas mensagens também são definidas em forma de recurso para facilitar a internacionalização do aplicativo. Por fim, fazemos o uso de strings formatadas com a notação %s, %1$s e %2$s. Essa estratégia é adotada para a geração de mensagens dinâmicas para as temperaturas e umidade de modo que apenas os valores sejam substituídos na hora da conversão.