API · MCP
사람 앱에도,
AI 에이전트에도.For apps.
For agents.
같은 키, 같은 크레딧으로 REST·JavaScript·MCP를 씁니다. 오류는 고치는 법까지 알려 주고, 한도는 머리글로 늘 보입니다.One key, one credit, across REST, JavaScript and MCP. Errors tell you how to fix them; limits are always in the headers.
미리보기Preview 지도 타일과 MCP는 운영 중, REST API는 공개 준비 중입니다.Tiles and MCP are live; the REST API is in preview.
GET /v1/pin/400-948-585-669?key=YOUR_KEY → { "lat": -17.82920, "lng": 31.05207, "cell_m": [20, 38], "country": "ZW", "nearby": [ { "type": "hotel", "name": "…", "pin": "400-939-585-672" } ] }
import { Pin } from '@wia/gils'; Pin.encode(37.5665, 126.9780); // '708-702-851-863' Pin.decode('400-948-585-669'); // [-17.8292, 31.0521]
claude mcp add --transport http gils https://gils.smilestory.ai/mcp
# tools
gils_pin_encode · gils_pin_decode · gils_address
gils_search_places · gils_braille · gils_space_distance · gils_iss_now
엔드포인트Endpoints
| 기능Family | 주소Pattern | 크레딧Credits | 상태Status |
|---|---|---|---|
| 벡터 지도Vector tiles | /tiles/{area}.pmtiles | 0.1 / 요청req | 운영Live |
| 핀코드 풀기Resolve Pin | /v1/pin/{code} | 1 | 미리보기Preview |
| 장소 검색Search places | /v1/places?q=&near= | 1 | 미리보기Preview |
| 근처 장소Nearby | /v1/nearby?pin=&type=embassy | 1 | 미리보기Preview |
| 경로Route | /v1/route?from=&to=&mode= | 2 | 미리보기Preview |
| 오프라인 팩Offline pack | POST /v1/offline-packs | 5 | 준비 중Coming |
| 정적 지도 이미지Static map | /v1/static?pin=&w=&h= | 1 | 준비 중Coming |
개발자가 덜 고생하도록Less pain for developers
🧪
키 없는 데모Key-less demo
가입 전에도 체험장과 예제가 그대로 돕니다.Playground and examples run before you sign up.
🩺
고치는 법까지 주는 오류Errors that explain the fix
{"code":"origin_not_allowed","fix":"Add https://you.app to key settings"}
📏
한도가 보이는 머리글Visible limits
X-Credits-Remaining · Retry-After
🛑
기본은 멈춤Stop by default
한도에 닿으면 멈춥니다. 더 쓰려면 $10 Top-up.At the limit, we stop. Need more? A $10 top-up.
🔐
안전한 키Safe keys
새 키는 사이트 제한이 켜진 채로. 짧게 사는 브라우저 토큰.New keys start origin-restricted. Short-lived browser tokens.