Herramientas para desarrolladores

Desarrolla con Mapcode

Empieza con la API REST si quieres probar los mapcodes rápidamente: la integración es sencilla y puedes obtener resultados en minutos. Usa una biblioteca, como TypeScript, cuando necesites codificación local o sin conexión, menor latencia, sin dependencia de red o sin costes de transferencia de datos de la API.

API REST: introducción API REST: ¡Pruébala!

Orden recomendado

  1. API REST para la integración inicial más rápida.
  2. TypeScript cuando necesites codificación local en aplicaciones web o Node.js.
  3. Python para scripts, análisis y flujos de trabajo en el backend.
  4. Java para aplicaciones existentes en JVM.

Inicio rápido con la API REST

Usa la API REST pública para probar el flujo de codificación y decodificación antes de elegir una integración más profunda. Estos ejemplos usan el Monte Kilimanjaro como punto de referencia neutral en África.

1. Coordenadas a mapcode

Solicita mapcodes para una coordenada cerca del Monte Kilimanjaro y restringe el resultado local a Tanzania.

Solicitud 
GET https://api.mapcode.com/mapcode/json/codes/-3.0674,37.3556?territory=TZA
Respuesta clave 
{
  "local": {
    "mapcode": "86.W6V5",
    "territory": "TZA"
  }
}

2. Mapcode a coordenadas

Decodifica el mapcode local de vuelta al punto central del área representada.

Solicitud 
GET https://api.mapcode.com/mapcode/json/coords/TZA%2086.W6V5
Respuesta clave 
{
  "latDeg": -3.0673755,
  "lonDeg": 37.3555635
}

Pequeñas diferencias en las coordenadas después de la decodificación son normales, ya que un mapcode representa un área pequeña en lugar del punto exacto de entrada original.

Abrir documentación completa de la API REST

Bibliotecas

Usa una biblioteca cuando quieras codificar y decodificar mapcodes dentro de tu propia aplicación sin depender de llamadas a la red.

TypeScript

La biblioteca recomendada para proyectos web, Node.js y TypeScript.

paquete npm Código en GitHub

Instalar 
npm install mapcode-ts
Codificar y 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

Usa Python para scripts, flujos de datos y servicios backend.

paquete PyPI Código en GitHub

Instalar 
pip install mapcode
Codificar y decodificar 
import mapcode

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

Java

Usa Java cuando estés integrando mapcodes en una aplicación JVM existente.

metadatos Maven Código en GitHub Documentación de Java

Dependencia Maven 
<dependency>
  <groupId>com.mapcode</groupId>
  <artifactId>mapcode</artifactId>
  <version>2.4.19</version>
</dependency>
Codificar y 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());

Otras herramientas

Estas herramientas siguen disponibles, pero la mayoría de las nuevas integraciones técnicas deberían comenzar con REST, TypeScript o Python.

Utilidad de línea de comandos

El código fuente de C/C++ incluye una utilidad multiplataforma de línea de comandos para codificar y decodificar mapcodes.

MyMapcodes.com

Es posible que desees usar MyMapcodes.com para encontrar mapcodes fácilmente, también en tu teléfono. MyMapcodes es un sitio web gratuito y no afiliado.

Herramientas heredadas

Las herramientas heredadas de Windows siguen disponibles por comodidad, pero no son la opción recomendada para nuevas integraciones.

Codificar ubicación -33.93, 18.8: 
mapcode -e -33.93, 18.8
Decodificarlo de nuevo: 
mapcode -d ZAF WK.QV5
Convertir un mapcode a coordenadas: 
=WEBSERVICE("https://api.mapcode.com/mapcode/xml/coords/Q4.HGY?context=NLD")
Convertir coordenadas de vuelta a mapcodes: 
=WEBSERVICE("https://api.mapcode.com/mapcode/xml/codes/52.460897,5.1074585")