Инструменты и загрузки для разработчиков

В этом разделе вы найдете инструменты, связанные с Mapcode. Если вас интересуют технические детали или исходный код системы Mapcode, в разделе для разработчиков вы найдете:

REST API

Фонд Mapcode управляет бесплатным публичным REST API, который преобразует координаты в mapcodes и обратно, а также предоставляет справочные данные по территориям и алфавитам. Он доступен для демонстрационных целей; для производственного использования вы можете разместить открытый исходный код сервера у себя.

Просмотреть полную документацию REST API

приложение для iOS и Android

На мобильных телефонах Android и iOS вы можете использовать приложение Mapcode Finder:

Эти приложения бесплатны. Они используют наши онлайн Mapcode REST API. Поскольку эти приложения будут отправлять данные о местоположении на наши серверы, ознакомьтесь с нашей политикой конфиденциальности, если хотите узнать, как мы обрабатываем такие данные. (Кратко: мы используем их для улучшения наших услуг, но не продаём и не предоставляем доступ к ним третьим лицам.)

macOS, Windows и Linux

Для MacOS, Windows и Linux мы предлагаем инструмент под названием Mapcode Utility, который позволяет кодировать и декодировать mapcode в интерфейсе командной строки.

Например, используйте следующую команду, чтобы закодировать местоположение 33.93, 18.8:

mapcode -e -33.93, 18.8

Используйте эту команду, чтобы декодировать снова:

mapcode -d ZAF WK.QV5

У утилиты есть множество дополнительных функций. Просто выполните команду "mapcode" без параметров, чтобы получить справочный текст.

Зависимость Maven

Чтобы использовать библиотеку Mapcode Java в вашем Maven-проекте, добавьте следующую зависимость в файл pom.xml:

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

Исходный код, примеры кода и документация доступны на нашей странице с исходным кодом на Java.

Преобразование местоположения в Mapcode и наоборот

Мы предлагаем кроссплатформенный консольный инструмент под названием Mapcode, который находится в каталоге утилит нашей библиотеки Mapcode для C/C++ и доступен для любой операционной системы. Вы можете найти утилиту здесь:

Вам нужно самостоятельно собрать эту утилиту на выбранной платформе.

Использование электронной таблицы для преобразования Mapcode

Вместо использования консольного инструмента для преобразования между местоположениями и Mapcode вы также можете использовать Excel (Windows) или Google Docs, чтобы напрямую вызывать наш бесплатный веб-сервис преобразования Mapcode.

Чтобы преобразовать Mapcode в местоположение, введите эту формулу в ячейку:

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

Это преобразует Mapcode в местоположение 52.460897, 5.1074585. Чтобы преобразовать местоположение обратно в его Mapcode, введите это:

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

Вы можете найти пример электронной таблицы здесь:

Google Docs предлагает аналогичные формулы для работы с веб-сервисами. Чтобы ознакомиться с кратким руководством по использованию веб-сервиса, нажмите здесь.

Устаревшие инструменты

Мы также предлагаем устаревшие инструменты для Windows для вашего удобства, хотя в какой-то момент они, скорее всего, будут сняты с поддержки. Консольная утилита mapcoder.exe позволяет быстро преобразовывать координаты в Mapcode и наоборот, обрабатывая целые электронные таблицы или базы данных за один раз. Полная документация прилагается.

Ради совместимости со старыми системами старое консольное приложение (версия 1.50.1) доступно на случай, если потребуется декодировать Mapcode версии до 2.0. Однако мы не рекомендуем использовать коды версии до 2.0.