맵 SDK와 맵 API는 제품 선택이 아니라 소유권 분할입니다. 맵 SDK는 재사용 가능한 클라이언트 측 구성 요소, 수명 주기 및 브라우저 인증을 패키징합니다. 맵 API는 프로그래밍 방식 요청을 통해 공간 서비스를 노출합니다. 맵 플랫폼은 두 레이어 외에도 인증, 데이터, 분석, 사용 제어 및 지원을 제공합니다. 대부분의 실제 맵 제품은 둘 이상의 레이어를 사용합니다.
아래 섹션에서는 세 가지 레이어를 구분하고 소유권을 지정한 다음, Kaleidr의 현재 공개 개발자 페이지를 기반으로 Kaleidr에 대한 문서를 작성합니다. 관련 자료로는 AI 지도 SDK란 무엇인가?, 노코드 지도 빌더 vs 지도 API, 지도 API 인증, 위치 인텔리전스 API란 무엇인가? 등이 있습니다. 이미 구현 방식을 선택한 팀은 Kaleidr 매핑으로 바로 이동할 수 있으며, 레이어 이름을 아직 정하지 않은 팀은 비교표부터 시작하는 것이 좋습니다.
비교 핵심 사항
- 작업 이름 다음에 레이어 이름을 지정하세요: SDK는 클라이언트 동작을 담당하고, API는 서비스 계약을 담당하며, 플랫폼은 공유 작업을 담당합니다.
- 계약 조건을 경쟁 관계로 취급하지 마십시오: 실제 제품에서는 SDK, API 및 플랫폼 제어 기능을 함께 사용하는 경우가 많습니다.
- 호스트 규칙의 권한을 우선시하십시오: ID, 테넌트 권한, 개인 기록 및 거래는 호스트 애플리케이션에 유지됩니다.
- 런타임별로 자격 증명을 분리하십시오: 브라우저에서 안전하게 공개할 수 있는 키와 서버 키는 서로 다른 위협 모델입니다.
- 현재 계약을 확인하십시오: Kaleidr 개발자 문서는 현재
kaleidr.js제품, 플랫폼 API 제품군 및 키 범위를 설명합니다. 마케팅 자료는 API 계약이 아닙니다.
맵 SDK와 맵 API는 맵 플랫폼과 어떻게 다른가요?
유용한 구분은 각 계층이 수행하는 작업에 있습니다. 맵 SDK는 클라이언트에 존재하며 재사용 가능한 동작(구성 요소, 마운트 수명 주기, 맵 첨부, 이벤트 및 브라우저 안전 세션 처리)을 패키징합니다. 맵 API는 검색, 경로 안내, 검색 결과 가져오기, 추론, 타일 또는 디자인과 같은 공간 기능을 위한 프로그래밍 계약입니다. 맵 플랫폼은 이 둘을 모두 포함할 수 있을 뿐만 아니라 인증, 데이터 서비스, 도구, 분석, 게시, 할당량 및 지원까지 포함하는 더 넓은 시스템입니다. AWS는 현재 SDK를 라이브러리와 같은 플랫폼별 빌드 도구 세트로 정의하고 있으며, API는 미리 정해진 프로토콜을 사용하여 두 소프트웨어 구성 요소가 통신할 수 있도록 하는 메커니즘이라고 정의하고 있습니다. 또한 SDK에는 다른 리소스와 함께 API가 포함될 수 있다고 언급합니다(SDK와 API의 차이점은 무엇인가요?).
벤더 플랫폼은 공개 문서에서 동일한 계층 구조를 사용합니다. Google은 현재 Google Maps Platform을 개발자가 앱과 페이지에 지도를 삽입하거나 Google Maps에서 데이터를 검색할 수 있도록 하는 API 및 SDK 세트로 설명합니다(Google Maps Platform FAQ). 같은 벤더는 현재 해당 기능을 플랫폼별 API 제품군으로 공개합니다(플랫폼별 Google Maps Platform API). Mapbox는 현재 개발자가 맞춤형 위치 경험을 위해 조합할 수 있는 API, SDK 및 도구로 구성된 모듈형 위치 플랫폼을 설명합니다(시작하기). 이러한 페이지는 각 벤더가 자체 스택에 이름을 붙이는 방식에 대한 공식적인 자료입니다. 하지만 이러한 페이지가 모든 제품이 단일 지오코드를 위해 전체 플랫폼을 구매해야 한다는 증거는 아닙니다.
| 질문 | 지도 SDK | 지도 API | 지도 플랫폼 |
|---|---|---|---|
| 주요 기능 | 재사용 가능한 클라이언트 측 동작 추가 | 프로그래밍 방식으로 서비스 접근 | 전체 공간 제품 스택 제공 |
| 일반적인 런타임 | 브라우저, 모바일 또는 앱 클라이언트 | 허용되는 경우 애플리케이션 계층 또는 클라이언트 | 클라이언트, 애플리케이션 계층 및 운영 도구 |
| 통합 방식 | 라이브러리, 컴포넌트, 로더 또는 패키지 | HTTP 또는 기타 서비스 요청 | SDK, API, 도구, 인증, 데이터 및 분석의 조합 |
| 최적 사용 분야 | UI, 지도 수명 주기, 임베드, 상호 작용 | 검색, 경로 안내, 추론, 데이터 검색 | 여러 공간 기능을 함께 필요로 하는 제품 |
| 주요 소유권 | 클라이언트 통합 | 서비스 계약 | 엔드투엔드 플랫폼 기능 |
| 인증 | 일반적으로 브라우저에서 안전하게 사용할 수 있는 키 또는 세션 | 일반적으로 서버 키 또는 범위가 지정된 토큰 | 키 관리, 범위, 할당량 및 조직 제어 |
| UI가 포함되어 있습니까? | 대부분 포함 | 일반적으로 포함하지 않음 | SDK UI와 API 및 도구가 포함될 수 있음 |
| 호스트 애플리케이션을 대체합니까? | 아니요 | 아니요 | 아니요, 인프라 및 구성 요소를 제공합니다. |
지도 SDK란 무엇입니까?
소프트웨어 개발 키트(SDK)는 개발자가 애플리케이션 내에서 직접 사용할 수 있는 코드를 패키징합니다. 지도의 경우, 이 패키지에는 종종 지도 구성 요소, 렌더러 어댑터, 컨트롤, 수명 주기 관리, 브라우저 안전 인증, 이벤트 처리, 구조화된 작업, 내장 뷰어 또는 편집기, 오류 정규화 등이 포함됩니다. SDK는 일반적으로 원시 서비스 호출보다 사용자 인터페이스에 더 가깝기 때문에 "기존 화면에 이 기능을 추가"해야 하는 작업이 있을 때 팀에서 SDK를 사용하게 됩니다.
웹 플랫폼은 이러한 패키징을 구체화합니다. MDN은 현재 사용자 정의 요소를 개발자가 정의하여 브라우저에서 사용할 수 있는 요소 집합을 확장하는 HTML 요소로 설명합니다(사용자 정의 요소 사용). 사용자 정의 요소를 설치하는 지도 SDK는 이러한 브라우저 계약을 사용합니다. 호스트 페이지는 구성 요소를 선언하거나 마운트하고, SDK는 버전 관리, 번들 로딩 및 수명 주기를 담당합니다. Kaleidr는 현재 kaleidr.js를 window.Kaleidr 및 <kaleidr-map> 요소를 설치하고 제품 번들을 지연 로드하며 버전 관리, 구성, 키 전달, 마운트 수명 주기 및 오류 정규화를 담당하는 얇은 로더로 문서화하고 있습니다(kaleidr.js — 로더).
SDK는 호스트 애플리케이션을 대체하지 않습니다. 호스트는 여전히 ID, 테넌트 권한, 개인 데이터 및 비즈니스 워크플로를 소유합니다. AI 관련 경우에도 이러한 경계는 동일합니다. SDK는 의도, 구조화된 장소 및 지도 작업을 실시간 렌더러에 연결하지만, 인벤토리 또는 자격에 대한 진실의 원천이 되지는 않습니다.
지도 API란 무엇인가요?
지도 API는 정의된 프로그래밍 계약을 통해 기능을 노출합니다. 일반적인 범주에는 장소 검색, 지오코딩, 경로 설정, 이동 시간 계산, 타일 요청, 정적 지도 생성, 공간 추론, 데이터 세트 관리 및 지도 디자인 작업이 포함됩니다. API는 일반적으로 인터페이스에서 결과가 어떻게 표시되어야 하는지 결정하지 않습니다. 호스트 애플리케이션이 결정합니다.
요청 모델은 일반적인 웹 아키텍처입니다. MDN은 현재 Fetch API를 Request 및 Response 객체를 사용하여 네트워크를 통해 리소스를 가져오는 인터페이스(Fetch API)로 설명합니다. 지도 API 호출은 공간 작업에 적용된 패턴입니다. 애플리케이션은 구조화된 요청을 보내고, 구조화된 응답 또는 스트림을 수신한 다음, 무엇을 렌더링할지 결정합니다. Kaleidr는 현재 플랫폼 API 경로를 https://api.kaleidr.com/inference-api/b2b/v1/ 아래에 배치하고 채팅, 경로 안내, POI 보강, SDK 세션 교환 및 디자인 패밀리에 대한 문서를 공개 엔드포인트 참조(Endpoints)에 제공합니다. 정확한 경로 목록은 변경될 수 있으므로 구현 시에는 블로그 예제보다는 최신 개발자 참조를 기준으로 삼아야 합니다.
사전 구축된 인터페이스 없이 서비스 응답이 필요한 경우 API 계층을 먼저 선택하십시오. 장소 컨텍스트 검색, 추론 서비스 호출, 경로 계산, 관심 지점 보강, 디자인 작업 실행 또는 이러한 호출을 개인 레코드와 함께 오케스트레이션하는 등의 작업을 수행할 수 있습니다. 장단점은 명확합니다. 애플리케이션은 자격 증명, 재시도, 오류 및 필요한 경우 스트리밍을 포함한 더 많은 통합 코드를 소유해야 합니다.
지도 플랫폼이란 무엇입니까?
지도 플랫폼은 공통 계정, 데이터, 보안 및 운영 모델을 중심으로 여러 구성 요소를 결합합니다. SDK와 API는 해당 모델 내에 포함될 수 있지만, 핵심적인 특징은 광범위한 기능과 공유 인프라(렌더링, 검색, 경로 안내, 장소 데이터, 타일, 지도 디자인, 인증, 사용 제어, 분석, 게시 및 지원)입니다. Google의 FAQ는 현재 Google Maps Platform을 단일 엔드포인트가 아닌 함께 사용되는 API 및 SDK로 설명합니다. Mapbox는 현재 동일한 개념을 지도, 검색, 내비게이션, 데이터 제품 및 Mapbox Studio와 같은 도구로 구분합니다.
플랫폼은 브라우저 인증 및 애플리케이션 계층 인증, 지도 UI, 타일, 편집기, 추론, 분석 및 사용 제어와 같이 여러 관련 문제가 동시에 중요할 때 가치가 있습니다. 단일 지오코드 또는 단일 정적 지도에는 이러한 운영 표면이 필요하지 않습니다. 노코드 빌더는 전체 플랫폼이 아니더라도 플랫폼 표면의 일부가 될 수 있으며, 제한적인 API도 적절한 시작점이 될 수 있습니다.
Kaleidr는 현재 개발자 도입을 AI, 지도 및 디자인 기능을 갖춘 조직 수준의 핵심 시스템으로 설명하며, 게시 가능한 형태와 서버 형태(Build with Kaleidr)를 제공합니다. Kaleidr Enterprise는 현재 해당 상용 스택을 기존 제품 스택을 위해 구축된 공간 인텔리전스로 구성하며, SDK, 추론 API, 순위 지정, 분석 및 배포 지원(Location Intelligence APIs and Map SDK)을 포함합니다. 특정 프로덕션 워크플로에 의존하기 전에 Pricing & Plans에서 현재 플랜 허용량을 확인하십시오.
각 책임은 어떤 계층에서 담당해야 할까요?
깔끔한 통합은 각 책임을 어떤 계층에서 담당할지 결정하는 것에서 시작됩니다. 호스트 애플리케이션은 ID, 테넌트 권한, 고객 상태, 개인 데이터, 트랜잭션 및 제품별 워크플로에 대한 권한을 유지해야 합니다. SDK는 마운팅, 재사용 가능한 인터페이스 동작, 지도 첨부, 브라우저 세션 처리 및 구성 요소 수명 주기를 담당할 수 있습니다. API는 추론, 경로 계산, 위치 정보 보강, 설계 작업 및 기타 서비스 응답을 담당할 수 있습니다. 플랫폼은 자격 증명, 범위, 할당량, 제품 액세스, 인프라, 지원 및 공유 청구를 담당할 수 있습니다. 이러한 경계를 넘나드는 것이 바로 개인 권한 부여가 위젯으로 유출되거나 언어 모델 응답이 예약 장부로 처리되는 방식입니다.
개인 레코드는 일반적으로 오케스트레이션을 애플리케이션 계층으로 푸시합니다. 목록, 재고, 고객 레코드, 운영 자산 및 보호된 비즈니스 규칙은 최소화된 결과가 지도에 도달하기 전에 호스트에서 권한 부여를 받아야 합니다. 브라우저 SDK는 여전히 결과를 표시할 수 있습니다. 지도 구성 요소는 권한 부여 서비스가 되어서는 안 됩니다. AI 지도 워크플로를 위한 개인 위치 데이터는 이러한 레코드의 최소화를 다룹니다. 멀티테넌트 SaaS 제품은 또 다른 경계를 추가합니다. 플랫폼 키는 SaaS 조직을 공급자에게 인증합니다. 이는 호스트가 어떤 고객이 어떤 지도나 개인 행을 볼 수 있는지에 대한 결정을 대체하는 것이 아닙니다.
팀은 언제 SDK, API 또는 플랫폼을 선택해야 할까요?
제품 요구 사항을 충족하는 가장 기본적인 통합부터 시작하고, 제어 또는 오케스트레이션이 필요할 때만 더 심층적인 통합으로 진행합니다. 디자인된 지도를 표시하는 것이 목적이라면 게시된 지도 또는 뷰어 임베드로 충분합니다. 호스트 인터페이스에 채팅, 편집기 또는 타일을 연결하는 것이 목적이라면 SDK 구성 요소로 충분합니다. 애플리케이션 계층에서 요청 구성, 개인 데이터 조인 또는 사용자 지정 UI를 직접 처리해야 하는 경우 플랫폼 API가 적절한 다음 단계입니다. 엔터프라이즈 통합은 거버넌스 및 운영 측면에서 선택하는 사항이며, 현재 렌더러를 대체해야 하는 필수 요건이 아닙니다.
웹 앱에서 지원되는 지도 기능을 신속하게 사용해야 하고, 기존 구성 요소 동작이 적합하며, 브라우저 통합이 적절한 경우 SDK 우선 방식을 선택하세요. 서비스 응답이 애플리케이션 계층에 속하고, 인터페이스가 사용자 정의되어 있거나, 개인 데이터 오케스트레이션이 중요한 경우에는 API 우선 방식을 선택하세요. 여러 공간 기능, 공유 인증, 사용량, 분석 및 엔터프라이즈 지원이 팀 전체에 걸쳐 중요한 경우에는 플랫폼 우선 방식을 선택하세요. 첫 번째 문제가 애플리케이션 코드보다는 지도 제작 및 게시인 경우 스튜디오 우선 방식을 사용하세요. Kaleidr Studio는 현재 해당 제작 경로를 문서화하고 있습니다. 이러한 경로는 호스트 지도를 다시 작성하지 않고도 나중에 통합될 수 있습니다.
Kaleidr는 이러한 레이어에 어떻게 매핑합니까?
Kaleidr는 현재 JavaScript SDK 계층과 플랫폼 API 계층을 제공하며, 엔터프라이즈 버전은 더 광범위한 상업 및 운영 표면을 제공합니다. 현재 개발자 빠른 시작 가이드는 https://cdn.kaleidr.com/embed/v1/kaleidr.js에 있는 하나의 버전 관리 로더를 사용합니다. 해당 로더는 chat, viewer, editor 및 tile용 제품 번들을 마운트할 수 있습니다. 현재 채팅은 렌더러를 교체하는 대신 라이브 호스트 Mapbox, MapLibre, Google Maps 또는 Leaflet 인스턴스에 연결됩니다(빠른 시작). Mapbox, Google Maps 및 MapLibre에 AI 채팅 추가 방법은 실습 연결 경로입니다. 대화형 지도 삽입 방법은 게시된 지도 삽입에 대해 설명합니다.
| 레이어 | Kaleidr 예시 | 일반적인 사용 |
|---|---|---|
| SDK | kaleidr.js, <kaleidr-map>, Kaleidr.mount() |
채팅, 뷰어, 편집기 또는 타일 동작 추가 |
| API | 플랫폼 API 엔드포인트 제품군 | 추론, 라우팅, 검색 또는 디자인 서비스 호출 |
| 플랫폼 | Kaleidr Enterprise 및 개발자 스택 | 기능, 키, 범위, 사용량, 지원 및 통합 관리 |
| 제작 도구 | Kaleidr Studio | 코드를 작성하지 않고 브랜드 지도 생성 및 게시 |
| 분석 레이어 | Kaleidr Analytics | 지도 및 장소 측정 참여 |
제품 번들은 하나의 구성 요소에 대해 서로 바꿔 쓸 수 있는 이름이 아닙니다. 뷰어는 게시된 지도를 표시하는 데 사용됩니다. 채팅은 실시간 호스트 지도에서 지도를 인식하는 대화형 상호 작용을 위한 것입니다. 편집기는 지도 제작 기능을 내장하는 데 사용되며, 지도 편집기 SDK는 해당 SaaS 사례를 지원합니다. 타일은 디자인된 기본 지도 스타일을 사용하는 데 사용됩니다. 제품 용도에 따라 선택하십시오. 기술 세부 정보는 페이지 위치 지정보다 빠르게 변경될 수 있습니다. 현재 개발자 빠른 시작 및 kaleidr.js 참조 문서에서는 게시된 뷰어가 공유 ID를 사용하며 키가 필요하지 않다고 명시하고 있습니다. 구현 시에는 개발자 문서를 기준으로 삼으십시오.
SDK와 API 간의 인증 방식은 어떻게 달라야 할까요?
브라우저 통합과 애플리케이션 계층 통합은 서로 다른 위협 모델을 가지고 있습니다. 브라우저로 전달되는 모든 것은 일반적으로 검사될 수 있으므로, 장기간 유지되는 서버 비밀 키는 페이지 소스, 클라이언트 번들 또는 공개 저장소에 포함되어서는 안 됩니다. Kaleidr는 현재 브라우저 SDK 사용을 위해 공개 가능한 키를 사용하며, SDK는 이를 단기적인 오리진 바인딩 세션으로 교환합니다. 서버 키는 신뢰할 수 있는 애플리케이션 계층에서 사용되며 베어러 또는 X-Api-Key 형식으로 전송될 수 있습니다. 현재 인증 참조에 따르면 베어러 형식으로 직접 제공되는 공개 가능한 키는 거부되고, 서버 키는 CORS 권한을 부여받지 못하며, SDK는 마운트 시 서버 키를 거부하여 서버 측에 유지되도록 합니다(Auth & scopes).
SDK는 일반적인 브라우저 경로를 숨길 수 있습니다. 현재 엔드포인트 참조 문서에는 POST /sdk/sessions가 공개 가능한 키를 허용하는 익스체인지로 명시되어 있으며, SDK가 일반 브라우저 통합에서 마운트 시 해당 익스체인지를 호출한다고 나와 있습니다(엔드포인트). SDK가 없으면 애플리케이션은 출처 유효성 검사, 제품 선택, 범위 검사, 단기 세션 교환 및 제품 번들 수명 주기를 직접 처리해야 합니다. 호스트가 요청 구성, 스트리밍, 재시도 및 개인 데이터 권한 부여를 제어해야 하는 경우에는 API를 직접 사용하는 것이 여전히 적절합니다. Kaleidr는 현재 누락되거나 유효하지 않은 자격 증명과 범위가 불충분한 유효한 자격 증명을 구분하고 별도의 속도 제한 조건을 문서화합니다. 애플리케이션 로그는 모든 오류를 "맵 실패"로 통합하는 대신 이러한 구분을 유지해야 합니다.
팀이 피해야 할 실수는 무엇일까요?
반복되는 오류는 유사한 용어를 대체재로 취급하는 것입니다. SDK와 API는 양자택일의 문제가 아닙니다. SDK는 종종 백그라운드에서 플랫폼 API를 호출합니다. SDK는 상위 수준의 개발자 인터페이스일 뿐, 서비스 계약이 존재하지 않는다는 증거는 아닙니다. API를 사용한다고 해서 모든 인터페이스를 처음부터 구축해야 하는 것은 아닙니다. 많은 제품에서 UI에는 SDK를, 애플리케이션 계층 오케스트레이션에는 API를 사용합니다. 플랫폼을 사용한다고 해서 기존 지도 스택을 교체해야 하는 것도 아닙니다. Kaleidr는 현재 기존에 지원되는 지도에 채팅 기능을 연결하는 방법을 문서화하고 있으며, Enterprise 버전은 기존 제품 스택을 기반으로 상업적 제안을 구성하고 있습니다.
| 오류 | 결과 | 더 나은 접근 방식 |
|---|---|---|
| SDK와 API를 상호 배타적으로 취급 | 아키텍처가 인위적으로 변함 | 각각을 적절한 계층에서 사용 |
| SDK가 비즈니스 로직을 소유한다고 가정 | 제품 경계가 모호해짐 | 호스트 규칙이 우선시되도록 유지 |
| 서버 키를 브라우저에 저장 | 자격 증명 노출 | 공개 가능한 SDK 인증 사용 |
| 일반적인 UI 요구 사항에 대해 API를 직접 호출 | 유지 관리해야 할 클라이언트 코드 증가 | 적합한 경우 SDK 사용 |
| 비공개 인증에 SDK 사용 | 테넌트 및 데이터 위험 | 호스트 애플리케이션에서 인증 |
| 플랫폼이 기존 지도를 대체한다고 가정 | 마이그레이션 비용 증가 | 지원되는 경우 첨부 |
| 마케팅 페이지를 API 계약으로 취급 | 기술적 불일치 | 최신 개발자 문서 우선 사용 |
| 사소한 요구 사항 하나를 위해 전체 플랫폼 도입 | 과도한 복잡성 | 가장 좁은 계층부터 시작 |
팀은 어떻게 통합을 시작해야 할까요?
작업에 맞는 레이어를 선택한 다음, 소유권이 필요한 경우에만 심도를 추가하세요. 재사용 가능한 클라이언트 동작에는 SDK를, 서비스 수준 제어에는 API를, 공유 공간 인프라에는 플랫폼을 사용하세요. Kaleidr는 현재 이 모델을 충실히 따르고 있습니다. kaleidr.js는 경량 브라우저 통합 레이어를 제공하고, 플랫폼 API는 문서화된 추론 및 설계 서비스를 제공하며, Kaleidr Enterprise는 공간 제품을 개발하는 팀을 위한 더 광범위한 상용 스택을 제공합니다. 현재 로더, 인증 및 엔드포인트 계약에 대한 자세한 내용은 **Kaleidr 개발자 문서 참조**를 참조하세요. SDK, 추론 API, 위치 인텔리전스 및 배포 지원에 대한 자세한 내용은 현재 공개 페이지에 설명된 **Kaleidr Enterprise 살펴보기**를 참조하세요.
자주 묻는 질문(FAQ)
지도 SDK와 지도 API의 차이점은 무엇인가요?
지도 SDK는 개발자가 UI, 수명 주기, 그리고 종종 브라우저 인증을 포함하여 지도 기능을 애플리케이션에 통합하는 데 도움이 되는 재사용 가능한 클라이언트 측 코드입니다. 지도 API는 특정 지도 또는 공간 서비스를 요청하는 데 사용되는 프로그래밍 인터페이스입니다. 많은 제품에서 둘 다 사용합니다.
지도 SDK는 단순히 API를 감싸는 래퍼인가요?
부분적으로는 그렇지만 항상 그런 것은 아닙니다. SDK는 UI 구성 요소, 지도 수명 주기, 브라우저 인증, 공급자 어댑터, 이벤트 및 오류 처리도 관리할 수 있습니다. AWS는 현재 SDK에 API를 비롯한 여러 리소스가 포함될 수 있다고 명시하고 있습니다.
지도 플랫폼이란 무엇인가요?
지도 플랫폼은 위치 기반 제품을 구축하는 데 사용되는 SDK, API, 데이터, 렌더링, 인증, 도구, 분석, 게시, 할당량 및 운영 서비스의 광범위한 집합입니다. Google과 Mapbox는 현재 자사의 상용 스택을 이러한 용어로 설명합니다.
팀은 SDK와 API 중 무엇을 사용해야 할까요?
지원되는 클라이언트 구성 요소가 제품에 적합한 경우 SDK를 사용하십시오. 호스트가 서비스 수준 제어 또는 애플리케이션 계층 오케스트레이션이 직접 필요한 경우 API를 사용하십시오. 많은 제품이 둘 다 사용합니다.
SDK가 지도 렌더러를 대체합니까?
반드시 그렇지는 않습니다. Kaleidr Chat은 현재 기존 Mapbox, MapLibre, Google Maps 또는 Leaflet 지도에 연결하는 기능을 제공합니다. Viewer 또는 Editor와 같은 다른 SDK 제품은 렌더러 소유권 모델이 다릅니다.
애플리케이션 계층에서 API 호출은 언제 이루어져야 합니까?
요청에 서버 자격 증명, 개인 데이터, 테넌트 권한 부여 또는 브라우저에 노출되어서는 안 되는 비즈니스 로직이 포함된 경우 애플리케이션 계층을 사용하십시오.
플랫폼 지도 빌더와 노코드 지도 빌더의 차이점은 무엇입니까?
노코드 지도 빌더는 제작 및 게시 기능에 중점을 둡니다. 플랫폼에는 빌더, SDK, API, 인증, 데이터 서비스, 분석 및 엔터프라이즈 제어 기능이 포함될 수 있습니다.
Kaleidr는 현재 SDK 및 API를 어떻게 제공합니까?
Kaleidr는 현재 window.Kaleidr 및 <kaleidr-map>를 설치하는 버전 관리형 kaleidr.js 로더를 사용하며, Chat, Viewer, Editor 및 Tile용 제품 번들이 포함되어 있습니다. 현재 공개된 플랫폼 API 문서에는 B2B 추론 API 기본 URL 아래에 채팅, 라우팅, POI 강화, SDK 세션 교환 및 디자인 제품군에 대한 내용이 포함되어 있습니다.
Kaleidr Viewer에는 공개 가능한 키가 필요합니까?
현재 개발자 빠른 시작 가이드와 kaleidr.js 참조 문서에서는 게시된 뷰어가 공유 ID를 사용하며 키가 필요하지 않다고 명시하고 있습니다.
Kaleidr는 기존 지도 스택과 호환됩니까?
Kaleidr는 현재 지원되는 라이브 호스트 지도에 채팅을 연결하는 기능을 문서화하고 있으며, Kaleidr Enterprise는 기존 스택을 위해 구축된 공간 인텔리전스 솔루션으로 제품을 홍보하고 있습니다. 기존 지도 제공업체를 대체하는 것이 핵심 목표는 아닙니다.
참조
- Amazon Web Services. SDK와 API의 차이점은 무엇입니까?. 2026년 9월 3일 접속. https://aws.amazon.com/compare/the-difference-between-sdk-and-api/
- Google Maps Platform. Google Maps Platform FAQ. 2026년 9월 3일 접속. https://developers.google.com/maps/faq
- Google Maps Platform. 플랫폼별 Google Maps Platform API. 2026년 9월 3일 접속. https://developers.google.com/maps/apis-by-platform
- Mapbox. 시작하기. 2026년 9월 3일 접속. https://docs.mapbox.com/help/getting-started/
- MDN. 사용자 정의 요소 사용. 2026년 9월 3일 접속. https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements
- MDN. Fetch API. 2026년 9월 3일 접속. https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API
- Kaleidr. Kaleidr로 빌드. 개발자 문서. 2026년 9월 3일 접속. https://docs.kaleidr.com/
- Kaleidr. 빠른 시작. 개발자 문서. 2026년 9월 3일 접속. https://docs.kaleidr.com/quickstart
- Kaleidr. kaleidr.js — 로더. 개발자 문서. 2026년 9월 3일 접속. https://docs.kaleidr.com/sdk/kaleidr-js
- Kaleidr. 권한 및 범위. 개발자 문서. 2026년 9월 3일 접속. https://docs.kaleidr.com/platform-api/auth-and-scopes
- Kaleidr. 엔드포인트. 개발자 문서. 2026년 9월 3일 접속. https://docs.kaleidr.com/platform-api/endpoints
- Kaleidr. 위치 인텔리전스 API 및 지도 SDK. 2026년 9월 3일 접속. https://kaleidr.com/enterprise
@misc{aws_sdk_api_difference_2026_09_03,
title = {What's the Difference Between SDK and API?},
author = {{Amazon Web Services}},
note = {Accessed 3 September 2026},
url = {https://aws.amazon.com/compare/the-difference-between-sdk-and-api/}
}
@misc{google_maps_platform_faq_2026_09_03,
title = {Google Maps Platform FAQ},
author = {{Google Maps Platform}},
note = {Accessed 3 September 2026},
url = {https://developers.google.com/maps/faq}
}
@misc{google_maps_apis_by_platform_2026_09_03,
title = {Google Maps Platform APIs by Platform},
author = {{Google Maps Platform}},
note = {Accessed 3 September 2026},
url = {https://developers.google.com/maps/apis-by-platform}
}
@misc{mapbox_getting_started_2026_09_03,
title = {Getting Started},
author = {{Mapbox}},
note = {Accessed 3 September 2026},
url = {https://docs.mapbox.com/help/getting-started/}
}
@misc{mdn_using_custom_elements_2026_09_03,
title = {Using custom elements},
author = {{MDN}},
note = {Accessed 3 September 2026},
url = {https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements}
}
@misc{mdn_fetch_api_2026_09_03,
title = {Fetch API},
author = {{MDN}},
note = {Accessed 3 September 2026},
url = {https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API}
}
@misc{kaleidr_docs_intro_2026_09_03,
title = {Build with Kaleidr},
author = {{Kaleidr}},
note = {Developer documentation; accessed 3 September 2026},
url = {https://docs.kaleidr.com/}
}
@misc{kaleidr_quickstart_2026_09_03,
title = {Quickstart},
author = {{Kaleidr}},
note = {Developer documentation; accessed 3 September 2026},
url = {https://docs.kaleidr.com/quickstart}
}
@misc{kaleidr_js_loader_2026_09_03,
title = {kaleidr.js -- the Loader},
author = {{Kaleidr}},
note = {Developer documentation; accessed 3 September 2026},
url = {https://docs.kaleidr.com/sdk/kaleidr-js}
}
@misc{kaleidr_auth_scopes_2026_09_03,
title = {Auth \& scopes},
author = {{Kaleidr}},
note = {Developer documentation; accessed 3 September 2026},
url = {https://docs.kaleidr.com/platform-api/auth-and-scopes}
}
@misc{kaleidr_endpoints_2026_09_03,
title = {Endpoints},
author = {{Kaleidr}},
note = {Developer documentation; accessed 3 September 2026},
url = {https://docs.kaleidr.com/platform-api/endpoints}
}
@misc{kaleidr_enterprise_2026_09_03,
title = {Location Intelligence APIs and Map SDK},
author = {{Kaleidr}},
note = {Accessed 3 September 2026},
url = {https://kaleidr.com/enterprise}
}