Strumenti per sviluppatori

Sviluppa con Mapcode

Inizia con l'API REST se vuoi provare i mapcode rapidamente: l'integrazione è semplice e puoi ottenere risultati in pochi minuti. Usa una libreria, come TypeScript, quando hai bisogno di encoding locale o offline, latenza ridotta, nessuna dipendenza di rete o costi di trasferimento dati dell'API.

API REST: introduzione API REST: Provala!

Ordine consigliato

  1. API REST per l'integrazione iniziale più rapida.
  2. TypeScript se vuoi l'encoding locale in app web o Node.js.
  3. Python per script, analisi e workflow backend.
  4. Java per applicazioni JVM esistenti.

Guida rapida all'API REST

Usa l'API REST pubblica per testare il flusso di encoding e decoding prima di scegliere un'integrazione più approfondita. Questi esempi utilizzano il Monte Kilimangiaro come punto di riferimento neutro in Africa.

1. Da coordinate a mapcode

Richiedi i mapcode per una coordinata vicino al Monte Kilimangiaro e limita il risultato locale alla Tanzania.

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

2. Da mapcode a coordinate

Decodifica il mapcode locale per ottenere il punto centrale dell'area rappresentata.

Richiesta 
GET https://api.mapcode.com/mapcode/json/coords/TZA%2086.W6V5
Risposta chiave 
{
  "latDeg": -3.0673755,
  "lonDeg": 37.3555635
}

Piccole differenze nelle coordinate dopo la decodifica sono normali perché un mapcode rappresenta una piccola area anziché il punto di input originale esatto.

Apri la documentazione completa dell'API REST

Librerie

Utilizza una libreria quando desideri codificare e decodificare mapcode all'interno della tua applicazione senza dipendere da chiamate di rete.

TypeScript

La libreria consigliata per progetti web, Node.js e TypeScript.

pacchetto npm Codice sorgente su GitHub

Installa 
npm install mapcode-ts
Codifica e decodifica 
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

Utilizza Python per script, workflow di dati e servizi backend.

pacchetto PyPI Codice sorgente su GitHub

Installa 
pip install mapcode
Codifica e decodifica 
import mapcode

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

Java

Utilizza Java quando integri i mapcode in un'applicazione JVM esistente.

metadati Maven Codice sorgente su GitHub Documentazione Java

Dipendenza Maven 
<dependency>
  <groupId>com.mapcode</groupId>
  <artifactId>mapcode</artifactId>
  <version>2.4.19</version>
</dependency>
Codifica e decodifica 
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());

Altri strumenti

Questi strumenti rimangono disponibili, ma la maggior parte delle nuove integrazioni tecniche dovrebbe iniziare con REST, TypeScript o Python.

Utility da riga di comando

Il codice sorgente C/C++ include un'utility multipiattaforma da riga di comando per la codifica e decodifica di mapcode.

MyMapcodes.com

Potresti voler usare MyMapcodes.com per trovare facilmente i mapcode, anche sul tuo telefono. MyMapcodes è un sito web gratuito e non affiliato.

Strumenti legacy

Gli strumenti legacy per Windows rimangono disponibili per comodità, ma non sono il percorso consigliato per nuove integrazioni.

Codifica la posizione -33.93, 18.8: 
mapcode -e -33.93, 18.8
Decodificala di nuovo: 
mapcode -d ZAF WK.QV5
Converti un mapcode in coordinate: 
=WEBSERVICE("https://api.mapcode.com/mapcode/xml/coords/Q4.HGY?context=NLD")
Converti le coordinate di nuovo in mapcode: 
=WEBSERVICE("https://api.mapcode.com/mapcode/xml/codes/52.460897,5.1074585")