Ontwikkelaarshulpmiddelen

Bouw met Mapcode

Begin met de REST API als je mapcodes snel wilt uitproberen: integratie is eenvoudig en je kunt binnen minuten resultaten behalen. Gebruik een bibliotheek, zoals TypeScript, wanneer je lokale of offline codering nodig hebt, lagere latentie, geen netwerkafhankelijkheid of geen API-datatransferkosten.

Begin met de REST API Bekijk de volledige API-documentatie

Aanbevolen volgorde

  1. REST API voor de snelste eerste integratie.
  2. TypeScript wanneer je lokale codering in web- of Node.js-apps wilt.
  3. Python voor scripts, analyse en backend-workflows.
  4. Java voor bestaande JVM-toepassingen.

REST API-snelstart

Gebruik de openbare REST API om de encodeer- en decodeerstroom te testen voordat je kiest voor een diepere integratie. Deze voorbeelden gebruiken de Mount Kilimanjaro als neutraal herkenningspunt in Afrika.

1. Coördinaten naar mapcode

Vraag mapcodes aan voor een coördinaat in de buurt van Mount Kilimanjaro en beperk het lokale resultaat tot Tanzania.

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

2. Mapcode naar coördinaten

Decodeer de lokale mapcode terug naar het middelpunt van het weergegeven gebied.

Verzoek 
GET https://api.mapcode.com/mapcode/json/coords/TZA%2086.W6V5
Belangrijkste respons 
{
  "latDeg": -3.0673755,
  "lonDeg": 37.3555635
}

Kleine coördinaatverschillen na het decoderen zijn normaal, omdat een mapcode een klein gebied vertegenwoordigt in plaats van het exacte oorspronkelijke invoerpunt.

Open volledige REST API-documentatie

Bibliotheken

Gebruik een bibliotheek als je mapcode-codering en -decodering binnen je eigen toepassing wilt uitvoeren zonder afhankelijk te zijn van netwerkaanroepen.

TypeScript

De aanbevolen bibliotheek voor web-, Node.js- en TypeScript-projecten.

npm-pakket Broncode op GitHub

Installeren 
npm install mapcode-ts
Coderen en decoderen 
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

Gebruik Python voor scripts, dataworkflows en backend-services.

PyPI-pakket Broncode op GitHub

Installeren 
pip install mapcode
Coderen en decoderen 
import mapcode

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

Java

Gebruik Java wanneer je mapcodes wilt integreren in een bestaande JVM-toepassing.

Maven-metadata Broncode op GitHub Java-documentatie

Maven-afhankelijkheid 
<dependency>
  <groupId>com.mapcode</groupId>
  <artifactId>mapcode</artifactId>
  <version>2.4.19</version>
</dependency>
Coderen en decoderen 
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());

Andere tools

Deze tools blijven beschikbaar, maar de meeste nieuwe technische integraties moeten beginnen met REST, TypeScript of Python.

Command-line utility

De C/C++-broncode bevat een platformonafhankelijke command-line utility voor het coderen en decoderen van mapcodes.

MyMapcodes.com

U kunt MyMapcodes.com gebruiken om mapcodes eenvoudig te vinden, ook op uw telefoon. MyMapcodes is een gratis, niet-aangesloten website.

Legacy tools

Legacy Windows-tools blijven voor het gemak beschikbaar, maar worden niet aanbevolen voor nieuwe integraties.

Codeer locatie -33.93, 18.8: 
mapcode -e -33.93, 18.8
Decodeer deze opnieuw: 
mapcode -d ZAF WK.QV5
Converteer een mapcode naar coördinaten: 
=WEBSERVICE("https://api.mapcode.com/mapcode/xml/coords/Q4.HGY?context=NLD")
Converteer coördinaten terug naar mapcodes: 
=WEBSERVICE("https://api.mapcode.com/mapcode/xml/codes/52.460897,5.1074585")