Outils pour développeurs

Développer avec Mapcode

Commencez par l'API REST si vous souhaitez tester rapidement les mapcodes : l'intégration est simple et vous obtiendrez des résultats en quelques minutes. Utilisez une bibliothèque comme TypeScript lorsque vous avez besoin d'un encodage local ou hors ligne, d'une latence réduite, d'aucune dépendance réseau ou d'aucun coût de transfert de données via l'API.

Commencer avec l'API REST Voir la documentation complète de l'API

Ordre recommandé

API REST pour une intégration initiale rapide.
TypeScript pour un encodage local dans les applications web ou Node.js.
Python pour les scripts, l'analyse et les workflows backend.
Java pour les applications JVM existantes.

Guide de démarrage rapide de l'API REST

Utilisez l'API REST publique pour valider le flux d'encodage et de décodage avant de choisir une intégration plus approfondie. Ces exemples utilisent le Mont Kilimandjaro comme repère neutre en Afrique.

1. Coordonnées vers mapcode

Demandez des mapcodes pour une coordonnée près du Mont Kilimandjaro et limitez le résultat local à la Tanzanie.

Requête

GET https://api.mapcode.com/mapcode/json/codes/-3.0674,37.3556?territory=TZA

Réponse clé

{
  "local": {
    "mapcode": "86.W6V5",
    "territory": "TZA"
  }
}

2. Mapcode vers coordonnées

Décodez le mapcode local pour retrouver le point central de la zone représentée.

Requête

GET https://api.mapcode.com/mapcode/json/coords/TZA%2086.W6V5

Réponse clé

{
  "latDeg": -3.0673755,
  "lonDeg": 37.3555635
}

De légères différences de coordonnées après décodage sont normales, car un mapcode représente une petite zone plutôt que le point exact d'origine.

Ouvrir la documentation complète de l'API REST

Bibliothèques

Utilisez une bibliothèque si vous souhaitez encoder et décoder des mapcodes directement dans votre application, sans dépendre d'appels réseau.

TypeScript

La bibliothèque recommandée pour les projets web, Node.js et TypeScript.

package npm Source sur GitHub

Installer

npm install mapcode-ts

Encoder et décoder

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

Utilisez Python pour les scripts, les flux de données et les services backend.

package PyPI Source sur GitHub

Installer

pip install mapcode

Encoder et décoder

import mapcode

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

Java

Utilisez Java pour intégrer les mapcodes dans une application JVM existante.

Métadonnées Maven Source sur GitHub Documentation Java

Dépendance Maven

<dependency>
  <groupId>com.mapcode</groupId>
  <artifactId>mapcode</artifactId>
  <version>2.4.19</version>
</dependency>

Encoder et décoder

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());

Autres outils

Ces outils restent disponibles, mais la plupart des nouvelles intégrations techniques devraient commencer par REST, TypeScript ou Python.

Matériel de référence

PDF techniques pour le système mapcode et questions fréquemment posées.

Utilitaire en ligne de commande

Les sources C/C++ incluent un utilitaire multiplateforme en ligne de commande pour encoder et décoder des mapcodes.

Source C/C++ Mapcode

Applications mobiles

Les applications gratuites Mapcode Finder utilisent l'API REST en ligne et sont utiles pour essayer les mapcodes sur un téléphone.

Tableurs

Les formules de tableur peuvent appeler directement l'API REST pour des expériences simples.

Voir la documentation complète de l'API REST

MyMapcodes.com

Vous pouvez utiliser MyMapcodes.com pour trouver facilement des mapcodes, également sur votre téléphone. MyMapcodes est un site web gratuit et non affilié.

Outils hérités

Les anciens outils Windows restent disponibles pour des raisons de commodité, mais ils ne sont pas recommandés pour les nouvelles intégrations.

Encoder l'emplacement -33.93, 18.8 :

mapcode -e -33.93, 18.8

Le décoder à nouveau :

mapcode -d ZAF WK.QV5

Convertir un mapcode en coordonnées :

=WEBSERVICE("https://api.mapcode.com/mapcode/xml/coords/Q4.HGY?context=NLD")

Convertir des coordonnées en mapcodes :

=WEBSERVICE("https://api.mapcode.com/mapcode/xml/codes/52.460897,5.1074585")