Tools en downloads voor ontwikkelaars
Op deze pagina vind je tools en documentatie voor het ontwikkelen van software die mapcodes gebruikt. Dat is handig als je meer wilt weten over de achtergrond en details van hoe mapcodes zijn gedefinieerd. Onze ontwikkelaar sectie omvat:
iOS en Android app
Op Android- en iOS-mobiele telefoons kun je de Mapcode Finder-app gebruiken:
Deze apps zijn gratis. Ze maken gebruik van onze online Mapcode REST API's. Aangezien deze apps locaties op aarde naar onze servers zullen sturen, verzoeken wij je ons privacybeleid te raadplegen als je meer wilt weten over hoe wij met dergelijke gegevens omgaan. (Kortom: we gebruiken het om onze diensten te verbeteren, maar verkopen het niet en verlenen ook geen toegang aan andere partijen.)
MacOS, Windows en Linux
Voor MacOS, Windows en Linux bieden wij een tool genaamd Mapcode Utility aan, waarmee je mapcodes kunt encoderen en decoderen via een command-line interface.
Gebruik bijvoorbeeld het volgende commando om de locatie 33.93, 18.8 te encoderen:
-
mapcode -e -33.93, 18.8
En gebruik dit commando om het weer te decoderen:
-
mapcode -d ZAF WK.QV5
De utility heeft veel meer opties. Voer gewoon "mapcode" zonder parameters uit om de helptekst te krijgen.
Maven dependency
Om de Mapcode Java Library in je Maven project te gebruiken, voeg je de volgende dependency toe aan je Maven pom.xml file:
<dependency>
<groupId>com.mapcode</groupId>
<artifactId>mapcode</artifactId>
<version>2.4.12</version>
</dependency>
Source code, voorbeeld code en documentatie kun je vinden op onze Java source code pagina.
Een spreadsheet gebruiken voor mapcodes
In plaats van de console tool om mapcodes te converteren, kun je ook een Excel (Windows) of Google Docs spreadsheet gebruiken, om met behulp van onze gratis web service mapcodes te converteren.
Om een mapcode naar een locatie te converteren, kun je in Excel bijvoorbeeld deze formule gebruiken:
=WEBSERVICE("http://api.mapcode.com/mapcode/xml/coords/Q4.HGY?context=NLD")
Dit converteert de mapcode Q4.HGY naar locatie 52.460897, 5.1074585. Omgekeerd, om een locatie terug te converteren naar een mapcode:
=WEBSERVICE("http://api.mapcode.com/mapcode/xml/codes/52.460897,5.1074585")
Hier vind je een voorbeeld spreadsheet in Excel (Windows):
Google Docs kan min of meer hetzelfde doen. Om te zien hoe dat werkt, klik hier.
Oudere tools
We bieden ook wat oudere Windows tools, hoewel deze op gegeven moment niet meer ondersteund kunnen worden. De console tool mapcoder.exe kan bijvoorbeeld heel snel coordinaten omzetten in mapcodes en vice versa, voor een heel spreadsheet of database. Volledige documentatie van de tool is inbegrepen.
De oudere versie van deze tool is ook nog beschikbaar (version 1.50.1). Deze is nodig om pre-2.0 codes te gebruiken. Het gebruik van pre-2.0 codes wordt afgeraden, maar we bieden deze tool nog voor het geval je er (nog) niet onderuit komt.