틀:지도/설명 문서

마지막 수정: 2026. 7. 20. 08:19:15 (6일 전)

편집 요청 토론 역사

분류

틀 설명 문서

편집 조건이 제한된 문서입니다.
문서의 ACL 탭
을 확인하세요.

[ 틀 설명 문서 ]

이 문서는 틀 설명 문서입니다.

목차

1. 개요2. 매개변수 목록3. 사용 방법

3.1. 주요 특징 및 주의사항

4. 예시

1. 개요 [편집]

틀:지도는 Google Maps Embed API와 Kakao 지도 API, 네이버 지도 API를 사용하는 틀입니다. 약관에 대해서는 각 서비스별 이용 약관을 참고하십시오.

2. 매개변수 목록 [편집]

모드 : 지도를 사용할 모드를 의미합니다. 구글, 카카오, 네이버 지도 중 선택할 수 있습니다. 기본 모드는 구글 지도입니다.
장소 : 표시할 위치의 주소 또는 좌표를 입력합니다.[1]
너비 : 지도의 가로 크기입니다. 기본값은 100%입니다.
높이 : 지도의 세로 크기입니다. 기본값은 400px입니다.
타입 : 지도 보기 방식인 일반, 위성, 하이브리드, 지형 중 하나를 설정합니다.
스타일 : iframe에 적용할 CSS 스타일을 직접 입력합니다.

3. 사용 방법 [편집]

[include(틀:지도, 장소=장소 또는 좌표, 너비=너비, 높이=높이, 모드=모드, 타입=타입, 스타일=스타일)]

3.1. 주요 특징 및 주의사항 [편집]

카카오 및 네이버 모드는 주소 검색을 기반으로 동작하므로, 좌표 입력 시 정상적인 지도가 출력되지 않을 수 있습니다.[2]
영어로 작성된 매개변수 명칭[3]을 지원하며, 한글 명칭과 동일하게 작동합니다.
외국 주소 입력 시 쉼표가 포함되어 있다면 쉼표를 제거해야 정상적인 검색이 가능합니다.
구글 지도 모드 사용 시 장소명 뒤에 &zoom=숫자를 추가하여 축척을 조정할 수 있습니다.

4. 예시 [편집]

[1] 좌표 설정은 구글 지도 모드에서만 정상적으로 작동합니다.[2] 카카오, 네이버 지도는 주소 기반 Geocoding을 사용합니다.[3] mode, place, width, height, style, type 등.