MapConductor문서 / 설정
프로바이더별 설정
MapConductor는 지도 SDK를 대체하는 것이 아니라, 그 위에 공통 API를 까는 것입니다. 지도를 그리는 코드는 공통이어도 SDK를 프로젝트에 넣는 절차 — 키 발급, 의존성 추가, 초기화 작법 — 는 각 사의 방식을 따라야 합니다. 여기서는 그 부분을 플랫폼과 프로바이더의 조합마다 정리했습니다.
ANDROID
10 providers
IOS
11 providers
REACT (WEB)
14 providers
01 · 대응표
지금 가이드가 준비된 조합입니다. 「—」는 그 플랫폼에 해당 프로바이더의 모듈이 없다는 뜻입니다.
React Native는 Google Maps・MapLibre・ArcGIS・HERE를 지원합니다. Web과 같은 상태 객체와 컴포넌트를 공유하므로 전용 설정 페이지를 두지 않고 각 React 페이지 안에서 다룹니다.
02 · 프로바이더 고르기
망설여진다면, 먼저 키가 필요 없는 프로바이더로 움직여 보고 나중에 갈아 끼우는 것이 빠릅니다. 공통 API로 써 두었다면 갈아 끼울 때 사라지는 작업은 거의 없습니다.
03 · 모든 가이드는 같은 형태
어느 페이지든 같은 순서로 되어 있습니다. 프로바이더를 옮길 때는 다른 부분만 읽으면 됩니다.
1 · 인증 정보
키나 토큰을 어디서 얻고, 어떻게 제한하는지.
2 · 의존 관계
어떤 저장소를 추가하고 어떤 모듈을 지정하는지.
3 · 초기화
키를 SDK에 넘기는 작법. 프로바이더 간 차이가 가장 큰 부분입니다.
4 · 동작 확인
붙여 넣으면 동작하는 최소한의 코드와, 잘 안 될 때 확인할 곳.
API KEYS
MapConductor는 키를 맡아 두지 않습니다
키는 각 지도 SDK가 요구하는 작법(Android의 매니페스트, iOS의 초기화 클로저, Web의 상태 객체)으로 그대로 전달됩니다. MapConductor가 중계하거나 저장하는 일은 없습니다. 따라서 키의 제한과 폐기 관리는 지금까지처럼 각 프로바이더의 콘솔에서 합니다.