개발자 도구

Mapcode로 빌드하기

빠르게 mapcode를 사용해 보고 싶다면 REST API로 시작하세요: 통합이 간단하며 몇 분 내에 결과를 얻을 수 있습니다. TypeScript와 같은 라이브러리는 로컬 또는 오프라인 인코딩, 낮은 지연 시간, 네트워크 의존성 없음 또는 API 데이터 전송 비용이 없을 때 사용하세요.

REST API: 소개 REST API: 사용해 보기!

추천 순서

  1. 가장 빠른 초기 통합을 위한 REST API.
  2. 웹 또는 Node.js 앱에서 로컬 인코딩이 필요할 때 TypeScript.
  3. 스크립트, 분석 및 백엔드 워크플로우를 위한 Python.
  4. 기존 JVM 애플리케이션을 위한 Java.

REST API 빠른 시작

공용 REST API를 사용하여 인코딩 및 디코딩 흐름을 증명한 후 더 깊은 통합을 선택하세요. 이 예제에서는 아프리카의 중립 랜드마크인 Kilimanjaro 산을 사용합니다.

1. 좌표를 mapcode로 변환

Kilimanjaro 산 근처의 좌표에 대한 mapcode를 요청하고 로컬 결과를 Tanzania로 제한합니다.

요청 
GET https://api.mapcode.com/mapcode/json/codes/-3.0674,37.3556?territory=TZA
주요 응답 
{
  "local": {
    "mapcode": "86.W6V5",
    "territory": "TZA"
  }
}

2. mapcode를 좌표로 변환

로컬 mapcode를 디코딩하여 해당 영역의 중앙 점으로 되돌립니다.

요청 
GET https://api.mapcode.com/mapcode/json/coords/TZA%2086.W6V5
주요 응답 
{
  "latDeg": -3.0673755,
  "lonDeg": 37.3555635
}

디코딩 후 작은 좌표 차이는 정상입니다. mapcode는 정확한 원래 입력 점이 아니라 작은 영역을 나타내기 때문입니다.

전체 REST API 문서 열기

라이브러리

네트워크 호출에 의존하지 않고 자체 애플리케이션에서 mapcode 인코딩 및 디코딩을 원할 때 라이브러리를 사용하세요.

TypeScript

웹, Node.js 및 TypeScript 프로젝트를 위한 권장 라이브러리입니다.

npm 패키지 GitHub 소스

설치 
npm install mapcode-ts
인코딩 및 디코딩 
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

스크립트, 데이터 워크플로우 및 백엔드 서비스에 Python을 사용하세요.

PyPI 패키지 GitHub 소스

설치 
pip install mapcode
인코딩 및 디코딩 
import mapcode

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

Java

기존 JVM 애플리케이션에 mapcode를 통합할 때 Java를 사용하세요.

Maven 메타데이터 GitHub 소스 Java 문서

Maven 종속성 
<dependency>
  <groupId>com.mapcode</groupId>
  <artifactId>mapcode</artifactId>
  <version>2.4.19</version>
</dependency>
인코딩 및 디코딩 
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());

기타 도구

이 도구들은 계속 사용할 수 있지만, 대부분의 새로운 기술 통합은 REST, TypeScript 또는 Python으로 시작하는 것이 좋습니다.

명령줄 유틸리티

C/C++ 소스 코드에는 위치 코드 인코딩 및 디코딩을 위한 크로스 플랫폼 명령줄 유틸리티가 포함되어 있습니다.

스프레드시트

스프레드시트 수식은 REST API를 직접 호출하여 간단한 실험을 수행할 수 있습니다.

MyMapcodes.com

MyMapcodes.com을 사용하여 휴대폰에서도 쉽게 mapcode를 찾을 수 있습니다. MyMapcodes는 무료이며, 공식과 무관한 웹사이트입니다.

레거시 도구

레거시 Windows 도구는 편의를 위해 여전히 제공되지만, 새로운 통합을 위해 권장되는 방법은 아닙니다.

위치 -33.93, 18.8 인코딩: 
mapcode -e -33.93, 18.8
다시 디코딩: 
mapcode -d ZAF WK.QV5
mapcode를 좌표로 변환: 
=WEBSERVICE("https://api.mapcode.com/mapcode/xml/coords/Q4.HGY?context=NLD")
좌표를 다시 mapcode로 변환: 
=WEBSERVICE("https://api.mapcode.com/mapcode/xml/codes/52.460897,5.1074585")