--- title: Configurar Instância CITSmart para Acesso via Mobile slug: citsmart8-pt/configurar-instancia-citsmart-para-acesso-via-mobile description: Learn how to configure your server to utilize the powerful CITSmart Experience application with this comprehensive documentation. Find out the specific prerequisites for your CITSmart version and the necessary parameter configurations. Discover step-by-st docTags: createdAt: 2022-01-14T19:46:34.000Z --- Este documento tem como objetivo **orientar para a configuração do servidor para uso do aplicativo** **CITSmart** **Experience**. ## Antes de começar - [x] É necessário Implantar a **versão 7.2.2.0** (ou superior) do **CITSmart**; - [x] Assim como configurar os parâmetros **257 **e **272**, sendo: * Valores: "S" ou "N". Default: "N" * Caso o valor do parâmetro seja “S”, poderão ser mostradas somente as notificações de solicitações sem responsável atual. * Caso o valor do parâmetro seja “N”, poderão ser mostradas as notificações de todas as solicitações. Os parâmetros 254 (`Parametrização > Sistema`), 255, 256, 258, 267, 284, 285, 286, 350 também devem ser configurados. ## Configurando os web services A configuração dos Web services são fundamentais para o acesso a todas as funcionalidades do aplicativo. Seguir os passos para melhor configurá-lo: 1. No **CITSmart** **Experience **(Web), acesse a funcionalidade de Web Services referente ao mobile (`Sistema > Configurações > Web Services CITSmart Mobile`); 2. Clique na aba “**Vincular Grupos**” e vincule o grupo executor de atividades aos Web Services do **CITSmart** **Experience Mobile**. :::hint{type="success"} ✅ ***Regra*****:** No momento que o grupo for selecionado ele será vinculado a todos os Web Services do **CITSmart** **Experience **de forma automatizada. ::: ## Instalação do certificado intermediário globalsign Para reconhecer o certificado intermediário da **GlobalSign **(Emissora do Certificado Digital) é necessário a instalação do mesmo: 1. Acesse o endereço: [https://support.globalsign.com/customer/portal/articles/1464460-domainssl-intermediate-certificates](https://support.globalsign.com/customer/portal/articles/1464460-domainssl-intermediate-certificates); 2. Depois de instalado, altere o endereço do aplicativo para suas necessidades (exemplo: “[https://citsmart.empresa.com.br/citsmart](https://citsmart.centralit.com.br/citsmart)”). ### Instalação do app Android/iOS 1. Acesse a loja (Play Store ou App Store) para baixar o aplicativo **CITSmart** **Experience Mobile**; 2. Pesquise por **CITSmart** **Experience **e após a pesquisa, selecione o aplicativo; 3. Pressione o botão "**Instalar**" para baixar o aplicativo. ### Criar chave para uso e consumo das APIs Google Para que seja possível o uso e consumo das APIs Google é necessário que uma API Key seja criada. Para isso, os seguintes passos devem ser seguidos: :::hint{type="warning"} ⚠️***Atenção*****!** Para realizar esses procedimentos é necessário estar logado com uma conta Google. ::: 1. Acesse o console do desenvolvedor Google [https://console.developers.google.com](https://console.developers.google.com/); 2. Clique em "**Criar um projeto**", conforme indicado na figura abaixo: 3. Será apresentada uma janela, conforme ilustrada na figura abaixo, para informar os dados do novo projeto; 4. Informe o nome do projeto e clique no botão "**Criar**" para criação do projeto. 5. Após criar o projeto, clique em `APIs e Serviços`. Para criar a API Key, clique em `APIs e Serviços > Credenciais > Criar Credenciais > Chave de API`, conforme indicado na figura abaixo: 6. Feito isso, a chave de API será apresentada: 7. Escolha a opção que melhor atenda a necessidade. Para mais informações sobre qual chave irá lhe atender, acesse [https://developers.google.com/console/help/new/#generatingdevkeys](https://developers.google.com/console/help/new/#generatingdevkeys). 8. Após as chaves criadas, as APIs já poderão ser consumidas. ### APIs a serem utilizadas nas soluções Segue abaixo as APIs do Google a serem consideradas nas soluções: ::Image[]{src="images/android-ios-7.jpg" size="50" caption="APIs" isUploading="false" showCaption="true"} - **Directions API: **a API de direções do Google é consumida através de requisições HTTP. Tal API calcula direções entre dois pontos informados, a origem e o destino, possuindo outras diversas opções. Para maiores informações sobre o uso dessa API, acesse: [https://developers.google.com/maps/documentation/directions](https://developers.google.com/maps/documentation/directions). - **Distance Matrix API: **a API Google Distance Matrix permite a recuperação de matrizes de distâncias entre dois pontos, ou seja, retorna também resultado aproximados. A diferença para a Google Directions API é que a Distance Matrix não retorna informações tão detalhadas, como os passos a serem realizados. Para maiores informações sobre o uso dessa API, acesse: [https://developers.google.com/maps/documentation/distancematrix](https://developers.google.com/maps/documentation/distancematrix). - **Geocoding API: **a Google geocoding API é uma API que ajuda a recuperar posições geográficas enviando como argumento um endereço por extenso. O consume da API é feito por HTTP e os resultados podem ser obtidos em XML ou JSON. Para maiores informações sobre o uso dessa API, acesse: [https://developers.google.com/maps/documentation/geocoding](https://developers.google.com/maps/documentation/geocoding). - **Statics Maps API: **a API para mapas estáticos do Google será utilizada em casos que não será necessário a interação como mapa, apenas visualização. É interessante seu uso uma vez que é mais leve, visto que não é necessário o download de recurso JS e imagens que não serão utilizadas. Para maiores informações sobre o uso dessa API, acesse: [https://developers.google.com/maps/documentation/staticmaps](https://developers.google.com/maps/documentation/staticmaps). - **Google Maps JavaScript API: **o uso da API é feito por meio de uma API JS. Para seu uso, basta linkar o JS na página que irá usar o maps. Para maiores informações sobre o uso dessa API, acesse: [https://developers.google.com/maps/documentation/javascript](https://developers.google.com/maps/documentation/javascript). ## Ativando uma API Para ativar uma API para uso, proceder conforme os passos descritos abaixo: 1. Após executar os passos descritos na seção "**Criar chave para uso e consumo das APIs Google**"; 2. Clique em `APIs e Serviços > Ativar APIs e Serviços`, conforme indicado na figura abaixo: 3. Será apresentada a biblioteca de APIs. Selecione a API que deseja ativar (a figura abaixo representa um exemplo de API) e clique no botão "**Ativar**" conforme indicado na figura abaixo: 4. Feito isso, a API estará habilitada para uso.