Entwicklertools

Entwickeln mit Mapcode

Beginnen Sie mit der REST-API, wenn Sie Mapcodes schnell ausprobieren möchten: Die Integration ist einfach und Sie erhalten in Minuten Ergebnisse. Verwenden Sie eine Bibliothek wie TypeScript, wenn Sie lokale oder Offline-Kodierung, geringere Latenz, keine Netzwerkabhängigkeit oder keine API-Datenübertragungskosten benötigen.

REST-API: Einführung REST-API: Ausprobieren!

Empfohlene Reihenfolge

  1. REST-API für die schnellste erste Integration.
  2. TypeScript, wenn Sie lokale Kodierung in Web- oder Node.js-Apps wünschen.
  3. Python für Skripte, Analysen und Backend-Workflows.
  4. Java für bestehende JVM-Anwendungen.

REST-API-Schnellstart

Verwenden Sie die öffentliche REST-API, um den Kodierungs- und Dekodierungsvorgang zu testen, bevor Sie eine tiefere Integration wählen. Diese Beispiele verwenden den Mount Kilimanjaro als neutralen Orientierungspunkt in Afrika.

1. Koordinaten in Mapcode umwandeln

Fordern Sie Mapcodes für eine Koordinate in der Nähe des Mount Kilimanjaro an und beschränken Sie das lokale Ergebnis auf Tansania.

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

2. Mapcode in Koordinaten umwandeln

Dekodieren Sie den lokalen Mapcode zurück zum Mittelpunkt des dargestellten Bereichs.

Anfrage 
GET https://api.mapcode.com/mapcode/json/coords/TZA%2086.W6V5
Wichtige Antwort 
{
  "latDeg": -3.0673755,
  "lonDeg": 37.3555635
}

Kleine Koordinatenunterschiede nach dem Dekodieren sind normal, da ein Mapcode einen kleinen Bereich und nicht den exakten ursprünglichen Eingabepunkt darstellt.

Vollständige REST-API-Dokumentation öffnen

Bibliotheken

Verwende eine Bibliothek, wenn du Mapcode-Kodierung und -Dekodierung direkt in deiner Anwendung ohne Netzwerkanfragen nutzen möchtest.

TypeScript

Die empfohlene Bibliothek für Web-, Node.js- und TypeScript-Projekte.

npm package Quellcode auf GitHub

Installieren 
npm install mapcode-ts
Kodieren und Dekodieren 
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

Verwende Python für Skripte, Daten-Workflows und Backend-Dienste.

PyPI package Quellcode auf GitHub

Installieren 
pip install mapcode
Kodieren und Dekodieren 
import mapcode

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

Java

Verwende Java, wenn du Mapcodes in eine bestehende JVM-Anwendung integrieren möchtest.

Maven metadata Quellcode auf GitHub Java documentation

Maven-Abhängigkeit 
<dependency>
  <groupId>com.mapcode</groupId>
  <artifactId>mapcode</artifactId>
  <version>2.4.19</version>
</dependency>
Kodieren und Dekodieren 
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());

Weitere Tools

Diese Tools bleiben verfügbar, aber die meisten neuen technischen Integrationen sollten mit REST, TypeScript oder Python beginnen.

Befehlszeilen-Tool

Die C/C++-Quelldateien enthalten ein plattformübergreifendes Befehlszeilen-Tool zum Kodieren und Dekodieren von Mapcodes.

MyMapcodes.com

Möglicherweise möchten Sie MyMapcodes.com verwenden, um Mapcodes einfach zu finden, auch auf Ihrem Smartphone. MyMapcodes ist eine kostenlose, nicht verbundene Website.

Ältere Tools

Ältere Windows-Tools bleiben aus Bequemlichkeit verfügbar, werden aber für neue Integrationen nicht empfohlen.

Standort -33.93, 18.8 kodieren: 
mapcode -e -33.93, 18.8
Erneut dekodieren: 
mapcode -d ZAF WK.QV5
Einen Mapcode in Koordinaten umwandeln: 
=WEBSERVICE("https://api.mapcode.com/mapcode/xml/coords/Q4.HGY?context=NLD")
Koordinaten zurück in Mapcodes umwandeln: 
=WEBSERVICE("https://api.mapcode.com/mapcode/xml/codes/52.460897,5.1074585")