틀:지도/설명 문서 (r3 RAW)

[[분류:틀 설명 문서]][include(틀:접근 제한)]
[include(틀:설명 문서)]
[목차]
== 개요 ==
[[틀:지도]]는 [[https://developers.google.com/maps/documentation/embed/embedding-map|Google Maps Embed API]]와 [[https://developers.kakao.com/docs/ko/kakaomap/common|Kakao 지도 API]], [[https://api.ncloud-docs.com/docs/application-maps-overview|네이버 지도 API]]를 사용하는 틀입니다. 약관에 대해서는 각 서비스별 이용 약관을 참고하십시오.
 * [[https://www.google.com/intl/ko_kr/help/terms_maps/|Google 지도/Google 어스 추가 서비스 약관]]
 * [[https://kakao.com/policy/terms|Kakao 서비스 약관]] 및 [[https://developers.kakao.com/terms/latest/ko/site/|Kakao Developers 운영정책]]
 * [[https://www.ncloud.com/policy/terms|네이버 클라우드 플랫폼 서비스 이용약관]]

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

== 사용 방법 ==
{{{#!wiki style="display: inline-block; border: 1.5px solid #ccc; background: #cccccc15; border-radius: 20px; padding: 5px 20px;"
{{{[include(틀:지도, 장소=장소 또는 좌표, 너비=너비, 높이=높이, 모드=모드, 타입=타입, 스타일=스타일)]}}}}}}

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

== 예시 ==
[include(틀:지도, 모드=구글, 장소=37.586484,126.974940)]
[include(틀:지도, 모드=카카오, 장소=서울특별시, 너비=500px, 높이=281px)]
[include(틀:지도, 모드=네이버, 장소=서울특별시 중구, 너비=500px, 높이=281px, 타입=satellite)]