Ferramentas para desenvolvedores

Crie com Mapcode

Comece com a REST API se quiser testar mapcodes rapidamente: a integração é simples e você pode obter resultados em minutos. Use uma biblioteca, como TypeScript, quando precisar de codificação local ou offline, menor latência, sem dependência de rede ou sem custo de transferência de dados da API.

API REST: introdução API REST: experimente!

Ordem recomendada

  1. REST API para a integração inicial mais rápida.
  2. TypeScript quando quiser codificação local em aplicativos web ou Node.js.
  3. Python para scripts, análise e fluxos de trabalho de backend.
  4. Java para aplicativos JVM existentes.

Início rápido com a REST API

Use a REST API pública para testar os fluxos de codificação e decodificação antes de escolher uma integração mais profunda. Estes exemplos usam o Monte Kilimanjaro como um marco neutro na África.

1. Coordenadas para mapcode

Solicite mapcodes para uma coordenada próxima ao Monte Kilimanjaro e restrinja o resultado local à Tanzânia.

Solicitação 
GET https://api.mapcode.com/mapcode/json/codes/-3.0674,37.3556?territory=TZA
Resposta principal 
{
  "local": {
    "mapcode": "86.W6V5",
    "territory": "TZA"
  }
}

2. Mapcode para coordenadas

Decodifique o mapcode local de volta ao ponto central da área representada.

Solicitação 
GET https://api.mapcode.com/mapcode/json/coords/TZA%2086.W6V5
Resposta principal 
{
  "latDeg": -3.0673755,
  "lonDeg": 37.3555635
}

Pequenas diferenças nas coordenadas após a decodificação são normais, pois um mapcode representa uma pequena área em vez do ponto exato de entrada original.

Abrir documentação completa da REST API

Bibliotecas

Use uma biblioteca quando quiser codificar e decodificar mapcodes dentro da sua própria aplicação, sem depender de chamadas de rede.

TypeScript

A biblioteca recomendada para projetos web, Node.js e TypeScript.

pacote npm Código-fonte no GitHub

Instalar 
npm install mapcode-ts
Codificar e decodificar 
import { encodeToShortest, decode, Territory } from "mapcode-ts";

const code = encodeToShortest(-3.0674, 37.3556, Territory.TZA);
console.log(code.getCodeWithTerritory()); // TZA 86.W6V5

const point = decode("TZA 86.W6V5");
console.log(point.getLatDeg(), point.getLonDeg());

Python

Use Python para scripts, fluxos de dados e serviços de backend.

pacote PyPI Código-fonte no GitHub

Instalar 
pip install mapcode
Codificar e decodificar 
import mapcode

print(mapcode.encode(-3.0674, 37.3556, "TZA")[0])
print(mapcode.decode("TZA 86.W6V5"))

Java

Use Java ao integrar mapcodes em uma aplicação JVM existente.

metadados Maven Código-fonte no GitHub Documentação Java

Dependência Maven 
<dependency>
  <groupId>com.mapcode</groupId>
  <artifactId>mapcode</artifactId>
  <version>2.4.19</version>
</dependency>
Codificar e decodificar 
import com.mapcode.Mapcode;
import com.mapcode.MapcodeCodec;
import com.mapcode.Point;
import com.mapcode.Territory;

Mapcode code = MapcodeCodec.encodeToShortest(-3.0674, 37.3556, Territory.TZA);
System.out.println(code.getCodeWithTerritory());

Point point = MapcodeCodec.decode("TZA 86.W6V5");
System.out.println(point.getLatDeg() + ", " + point.getLonDeg());

Outras ferramentas

Essas ferramentas continuam disponíveis, mas a maioria das novas integrações técnicas deve começar com REST, TypeScript ou Python.

Utilitário de linha de comando

O código-fonte C/C++ inclui um utilitário de linha de comando multiplataforma para codificar e decodificar mapcodes.

MyMapcodes.com

Você pode querer usar MyMapcodes.com para encontrar mapcodes facilmente, inclusive no seu telefone. MyMapcodes é um site gratuito e não afiliado.

Ferramentas legadas

Ferramentas legadas para Windows permanecem disponíveis por conveniência, mas não são o caminho recomendado para novas integrações.

Codificar localização -33.93, 18.8: 
mapcode -e -33.93, 18.8
Decodificar novamente: 
mapcode -d ZAF WK.QV5
Converter um mapcode em coordenadas: 
=WEBSERVICE("https://api.mapcode.com/mapcode/xml/coords/Q4.HGY?context=NLD")
Converter coordenadas de volta para mapcodes: 
=WEBSERVICE("https://api.mapcode.com/mapcode/xml/codes/52.460897,5.1074585")