O Mingle disponibiliza acesso aos serviços do Google Maps Platform para permite que os desenvolvedores de aplicativos e portais da Totvs .
Com a chave de API Google disponibilizada pelo Mingle o desenvolvedor terá a sua disposição os seguintes serviços:
O primeiro passo é solicitar acesso ao serviço Maps para a equipe do Mingle através do e-mail [email protected], é necessário informar o nome do aplicativo e o responsável técnico.
Após ter o acesso liberado, utilize nossa documentação oficial para obter a chave:
https://mingle.totvs.com.br/api/docs/#api-Maps-GetGmapsKey
acessem os serviços do Google Maps Platform sem precisar adquirir uma chave de uso. Isso simplifica o processo de integração e facilita o desenvolvimento de aplicativos que utilizam o serviço.
Através da API gmaps.gateway fornecida pelo Mingle, os desenvolvedores podem acessar diversos serviços oferecidos pelo Google Maps, incluindo:
...
Para aumentar a produtividade do desenvolvedor, criamos a classe GMapsService no pacote @totvsgmaps.gateway no pacote @totvs/mingle e nele é possível adquirir a os serviços disponibilizado pelo Google Maps Key atualizada e o Maps Javascript API
O primeiro passo para usar o serviço é a declaração do MingleService, para mais detalhes acesse a documentação a seguir: 4- Autenticação.
Para usar a API do Google Maps no Mingle, siga o exemplo de código abaixo:
1 - GeocodeApós a declaração do MingleService siga o exemplo do código abaixo:
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
getGmapsKeygeocodeAddress(){ const endpoint = `geocode/json?address="${this.address}"` this.mingleService.gmaps.getGMapsKeygateway(endpoint).subscribe(response => { const this.keylat = JSON.stringify(response); response.results[0].geometry.location.lat; },const errorlong => { response.results[0].geometry.location.lng; console.log(error.response.data.msg)const urlGoogle = `https://maps.google.com/?q=${lat},${long}`; }); } |
Para obter o Maps Javascript API, siga o exemplo do código abaixo: 2 - Google Maps JavaScript
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
getGMapsJsgetJavaScript() { this.mingleService.gmaps.getGMapsJsgateway().subscribe(response => { this.gMapsJs = response; }, error => { console.log(response); //retorno do javascript console.log(error.response.data.msg}); }) } } |
No exemplo acima, utilizou-se o endpoint geocode fornecido pelo Google Maps. É importante ressaltar que os demais serviços disponibilizados pelo Google Maps também podem ser utilizados.