Criando sua Widget do SATF

O SATF possuí uma Widget que pode ser adicionada em sites, fóruns, redes sociais, entre outros. Dessa forma, essa poderosa ferramenta não fica restrita ao site satf.fefico.com.

Para criar sua aplicação, basta acessar a seguinte página:

Na versão 2.1 do SATF, é possível verificar 3 opções distintas para configurar sua página. A primeira delas, é composta de algumas modificações básicas, principalmente em campos de dados visíveis, sendo que esta não fica oculta. Já a segunda opção, seta todas as configurações do botão “Configurar” do SATF, ficando oculta suas modificações. E por fim, temos opções extras,voltadas principalmente para as configurações iniciais do mapa.

Todos os dados são alterados por parâmetros adicionados na URL, e os mesmos já possuem valores padrões (default). São aceitas dezenas de modificações, para deixar o SATF a sua cara, ou a dos seus visitantes.

CONFIGURAÇÕES BÁSICAS

Modifica as configurações mais básicas do SATF, visíveis em toda a página.

Google Maps JavaScript API :

Parâmetro: api

Default: AIzaSyCQDHjoGzXDg-tEN1XN-_H41P-7_s7HjkY

A primeira configuração do SATF, é a inserção da chave do Google Maps JavaScript API. Essa chave possui 39 caracteres, podendo conter letras, números, traços e underline. Portanto, existe um limite diário de 25.000 visualizações de mapas por chave. Assim, recomendamos que cada usuário tenha sua chave, obtendo informações e maior segurança no uso do SATF.

Por padrão o SATF insere sua própria chave API, mas você pode gerar a sua gratuitamente:

Quando a borda deste campo estiver Verde após um Focus Out, indica que a chave pode estar correta. Vermelho indica que está errada e não será adicionada a URL. Caso insira uma chave inválida como parâmetros, o resultado será o seguinte:

Ops! Algo deu errado.
Esta página não carregou o Google Maps corretamente. Consulte o console JavaScript para ver detalhes técnicos.

Satélite:

Parâmetro: set_sat

Default: 180 ou 179.9832

Esta opção retorna o satélite inicial ao carregar o mapa. Existem duas listas de satélites, basta selecionar a que mais lhe agrada. Por padrão, a primeira lista, retorna por Default o satélite na posição 180ºE, e a segunda lista o satélite na posição 179.9832ºE, sendo estes o mesmo satélite. Este campo aceita números  decimais que vão de -180º a 180º.
Caso não queira setar nenhum satélite, basta deixar a primeira lista em — Seleciona um satélite — e a segunda lista em — Seleciona um satélite (FULL) —

Existe outro parâmetro nessa opção, que é a lista de satélites desejada:

Parâmetro: list_sat

Default: none - retorna a lista simples de satélites.

A lista simples de satélites, é setada na opção — Seleciona um satélite —. Ela possui um pouco mais de 200 satélites Geoestacionários, em sua maioria voltados para a banda C e KU.

Já a lista completa, recebe como Default a opção — Seleciona um satélite (FULL) –, tendo mais de 400 satélites adicionados. Possuem valores de longitude e latitude mais precisos, mas muitos dos satélites não são voltados para a banda C e KU.

Para inserir a lista completa em sua aplicação, basta selecionar o SELECT FULL, contendo ou não uma opção selecionada.

Idioma:

Parâmetro: lang

Default: none - pt-BR

Validação: xxx-xxx

Usos: Geral

Seta o idioma de inicialização do SATF. Para maiores detalhes acesse o Link abaixo:

 

Posição:

Seta a posição inicial da antena no mapa. Ela é provida de 3 parâmetros, de acordo com a sua seleção.

Parâmetro: lat

Default: -20.269379540201626

Latitude: retorna o valor entre -90º e +90º, possuí como Default a latitude -20.269379540201626, representada pelo parâmetro lat.

Parâmetro: lng

Default: -40.2946610010498

Longitude: retorna o valor entre -180º e +180º, possuí como Default a longitude de -40.2946610010498, representada pelo parâmetro lng.

Quando selecionadas, estas recebem o valor setado na Widget, de acordo com a posição do Marker no mapa. Ao carregar a página, aparecerá um pedido para pegar seus valores de Latitude e Longitude, caso não aceite, basta mover o Marker para a posição desejada no mapa, ou buscar uma localidade no campo de texto.

*Todo navegador atual, possuí configurações de geolocalização, certifique se o seu esta ativado.

Parâmetro: local

Default: none

Este parâmetro seta a localidade que a antena será apontada. Ele não possuí um valor Default, mas quando setado se sobressai sobre os parâmetros de Longitude e Latitude. Para buscar este valor, pode-se usar o movimento do Marker, ou o input para busca de localidade. Caso esta não retorno o nome da localidade selecionada, gerara um erro de ZERO_RESULTS, não podendo setar o parâmetro.

*Para uma maior precisão, recomendasse o uso dos parâmetros lat e lng.

Cor de fundo:

Parâmetro: bg

Default: #FFFFFF

Este parâmetro seta a cor de fundo da página. É utilizado valores hexadecimais, contendo números de 0 a 9 e letras de A a F. Diferente das opções já citadas, você deverá desbloquear esta opção, clicando no cadeado do título. Caso venha digitar um valor errôneo,retornará uma cor de fundo vermelha, não sendo adicionado o parâmetro a URL.

É possível adicionar 16.777.216 cores diferentes.

Altura do Iframe:

Parâmetro: none

Default: 715

O valor não é setado na URL, mas diretamente na altura do iframe. Existe um atributo chamado de height, onde é adicionado um valor que varia de 615 a 2000 pixels, mas nada impede que adicione outros valores diretamente no código. Para utilizar esta opção, você deverá desbloquear o cadeado.

BOTÃO CONFIGURAÇÕES

Este botão é utilizado para liberar as modificações dos parâmetros no botão de configurações do SATF. Todos os valores deverão ser desbloqueados, clicando no cadeado de cada título, e para a inserção destes, será necessário que o botão não esteja oculto.

Altura do prato na antena Ku:

Parâmetro: ant_alt_ku

Default: 65

Validação: [15,1000]

Usos: Distância Focal banda Ku, F/D ratio banda Ku, Ganho antena banda Ku, Ângulo Offset e Inclinômetro na antena (Offset)

Valor referente a altura da antena desejada na Banda ku em cm. Este valor deverá ser maior que a Largura da antena ku.

Largura do prato na antena Ku:

Parâmetro: ant_lar_ku

Default: 61

Validação: [15,1000]

Usos: Inclinômetro na antena (Offset) e Ângulo Offset

Valor referente a largura da antena desejada na Banda ku em cm. Este valor deverá ser menor que a Altura da antena ku.

Profundidade do prato na antena Ku:

Parâmetro: ant_prof_ku

Default: 5

Validação: [1,500]

Usos: Distância Focal banda Ku e F/D ratio banda Ku

Valor referente a profundidade da antena Ku em cm.

Eficiência da antena na banda Ku:

Parâmetro: ant_prof_ku

Default: 5

Validação: [10,100]

Usos: Ganho antena banda Ku

Valor referente a eficiência de uma determinada antena na banda Ku.

Parâmetro: ant_fre_ku

Default: 11625

Validação: [10750,12750]

Usos: Ganho antena banda Ku

Valor referente a frequência média na banda ku.

Parâmetro: ant_alt_c

Default: 150

Validação: [20,1000]

Usos: Distância Focal banda C, F/D ratio banda C e Ganho antena banda C

Valor referente ao tamanho da antena em cm.

Parâmetro: ant_efi_c

Default: 55

Validação: [10, 100]

Usos: Ganho antena banda C

Valor referente a eficiência da antena na banda C.

Parâmetro: ant_fre_c

Default: 3950

Validação: [3400, 4800]

Usos: Ganho antena banda C

Valor referente a frequência média desejada na banda C.

Parâmetro: ant_prof_c

Default: 27.5

Validação: [3400, 4800]

Usos: Distância Focal banda C e F/D ratio banda C

Valor referente a profundidade da antena na banda C.

Parâmetro: val_dia

Default: dia atual

Validação: [1, 31]

Usos: Azimute solar

Valor referente ao dia que será usado no cálculo do azimute solar.

Parâmetro: val_mes

Default: mês atual

Validação: [1, 12]

Usos: Azimute solar

Valor referente ao mês que será usado no cálculo do azimute solar.

Parâmetro: val_ano

Default: ano atual

Validação: [1980,2050]

Usos: Azimute solar

Valor referente ao ano que será usado no cálculo do azimute solar.

Parâmetro: val_hora

Default: hora atual

Validação: [0,23]

Usos: Azimute solar

Valor referente a hora que será usado no cálculo do azimute solar.

Parâmetro: val_minuto

Default: minutos atuais

Validação: [0,59]

Usos: Azimute solar

Valor referente ao minuto que será usado no cálculo do azimute solar.

Parâmetro: val_segundo

Default: segundos atuais

Validação: [0,59]

Usos: Azimute solar

Valor referente ao segundo que será usado no cálculo do azimute solar.

Parâmetro: val_time_zone

Default: *180

Validação: [-900,900]

Usos: Azimute solar

Valor referente ao Time Zone que será usado no cálculo do azimute solar.

*Por default, o Time Zone é 180 (-3 horas), mas este é provido do PC que acessa o SATF automaticamente.

Parâmetro: val_obs_int

Default: 10

Validação: [2,10]

Usos: Gráfico e Mapa

O Intervalo no mapa em relação ao Obstáculo distância (Metros). Obs: Caso retorne um número inteiro em sua divisão, o valor será referente a distância de cada obstáculo (ex: 50 / 10 = 5 {tendo 4 obstáculos}). Do contrário, ele irá dividir as distâncias desejadas de acordo com o valor reduzido a um inteiro (ex: 50 / 8 = 6,25 {Reduzido a 6, tendo 5 obstáculos}).

Parâmetro: val_dis_obs

Default: 50

Validação: [10,50]

Usos: Gráfico e Mapa

Valor referente a distância em metros usada no mapa para o uso no gráfico.

Parâmetro: val_alt_ant

Default: 2

Validação: [0,8000]

Usos: Elevação da antena e Elevação em graus (Todos utilizados diretamente no mapa)

Valor referente a altura da antena em relação ao solo.

Parâmetro: val_per_cab

Default: 10

Validação: [1,1000]

Usos: Perda cabo RG59 (1450MHz), Perda cabo RG06 (1450MHz) e Perda cabo RG11 (1450MHz)

Valor referente a distância de uso de cabos em sua instalação na banda C.

Parâmetro: val_per_cab_ku

Default: 10

Validação: [1,1000]

Usos: Perda cabo RG59 (1450MHz), Perda cabo RG06 (1450MHz) e Perda cabo RG11 (1450MHz)

Valor referente a distância de uso de cabos em sua instalação na banda Ku.

Parâmetro: val_gan_map

Default: 40

Validação: [20,80]

Usos: Tamanho antena Banda C

Valor referente ao ganho na banda C em uma determinada localidade no mapa de cobertura de um determinado satélite.

Parâmetro: val_gan_map_ku

Default: 50

Validação: [20,80]

Usos: Tamanho antena Banda ku

Valor referente ao ganho na banda Ku em uma determinada localidade no mapa de cobertura de um determinado satélite.

OPÇÕES EXTRAS

As opções extras se comportam em grande parte em melhorias visuais do mapa. São todas inciadas no carregamento e podem ser alteradas após este.

*Se o botão estiver oculta, não será adicionados os parâmetros selecionados.

Parâmetro: zoom

Default: 5

Validação: [0,21]

Usos: Mapa

Valor inicialmente adicionado no zoom do mapa.

*É preciso desbloquear o cadeado para alterar esta opção.

**Deve-se tomar cuidados em adicionar zoom elevado, pois as imagens podem não ser carregadas. Recomenda-se testá-las antes de adicionar o código a página.

Parâmetro: mobile

Default: *70

Validação: [0,21]

Usos: Mapa

Valor inicialmente adicionado como largura do mapa. Esta opção pode melhorar a visibilidade e o toque em dispositivos móveis, para aqueles que acessam diretamente o link do aplicativo.

*Por Default na Widget é 70, mas essa opção não vem ativada.

Parâmetro: cf

Default: false

Validação: true

Usos: Botão configurações

Ativa o botão configurações, deixando a modal visível ao inciar o mapa.

Parâmetro: nd

Default: false

Validação: true

Usos: Overlay Dia/Noite

Ativa o carregamento da overlay dia/noite, mostrando em quais pontos do mapa é dia e quais é noite.

Parâmetro: t_map

Default: [5, "SATELLITE"]

Validação: [2, "ROADMAP"],[3, "TERRAIN"],[4, "HYBRID"], [5, "SATELLITE"]

Usos: Tipo de Mapa

Carrega os tipos de mapas que podem ser exibidos usando a Google Maps.

ROADMAP –  exibe o mapa de vias padrão. Esse é o tipo de mapa padrão.

SATELLITE  – exibe imagens de satélite do Google Earth.

HYBRID – exibe uma combinação de visualizações normais e de satélite.

TERRAIN  – exibe um mapa físico baseado em informações do terreno.

Deixe uma resposta