Maps Service

지도

이 서비스를 사용하면 스크립트에서 정적 지도를 생성하고, 경로를 찾고, 주소를 지오코드 좌표로 변환하고 고도를 샘플링할 수 있습니다.

클래스

이름간략한 설명
Avoid경로를 찾을 때 피해야 할 제한사항 유형을 나타내는 enum입니다.
Color지도 이미지에서 사용할 수 있는 이름이 지정된 색상을 나타내는 enum입니다.
DirectionFinder위치 간의 경로를 검색할 수 있습니다.
DirectionFinderEnumsDirectionFinder에서 사용하는 enum 컬렉션입니다.
ElevationSampler특정 위치의 고도를 샘플링할 수 있습니다.
Format지도 이미지의 형식을 나타내는 enum입니다.
Geocoder주소와 지리적 좌표 간의 변환을 허용합니다.
Maps경로 찾기, 지오코딩, 고도 샘플링, 정적 지도 이미지 생성을 지원합니다.
MarkerSize지도에 추가된 마커의 크기를 나타내는 열거형입니다.
Mode경로를 찾을 때 사용할 이동 수단을 나타내는 열거형입니다.
StaticMap정적 지도 이미지를 만들고 장식할 수 있습니다.
StaticMapEnumsStaticMap에서 사용하는 enum 컬렉션입니다.
Type렌더링할 지도 유형을 나타내는 열거형입니다.

Avoid

속성

속성유형설명
TOLLSEnum유료도로를 제외하세요.
HIGHWAYSEnum고속도로를 제외하세요.

Color

속성

속성유형설명
BLACKEnum
BROWNEnum
GREENEnum
PURPLEEnum
YELLOWEnum
BLUEEnum
GRAYEnum
ORANGEEnum
REDEnum
WHITEEnum

DirectionFinder

방법

메서드반환 유형간략한 설명
addWaypoint(latitude, longitude)DirectionFinder지점 (위도/경도)을 사용하여 경로가 통과해야 하는 경유지를 추가합니다.
addWaypoint(address)DirectionFinder주소를 사용하여 경로가 통과해야 하는 경유지를 추가합니다.
clearWaypoints()DirectionFinder현재 경유지 집합을 지웁니다.
getDirections()Object출발지, 목적지 및 설정된 기타 옵션을 사용하여 경로를 가져옵니다.
setAlternatives(useAlternatives)DirectionFinder최고 순위 경로만 반환하는 대신 대체 경로를 반환해야 하는지 여부를 설정합니다 (기본값은 false).
setArrive(time)DirectionFinder원하는 도착 시간을 설정합니다 (해당하는 경우).
setAvoid(avoid)DirectionFinder특정 유형의 제한을 피할지 여부를 설정합니다.
setDepart(time)DirectionFinder원하는 출발 시간을 설정합니다 (해당하는 경우).
setDestination(latitude, longitude)DirectionFinder점 (위도/경도)을 사용하여 경로를 계산할 종료 위치를 설정합니다.
setDestination(address)DirectionFinder주소를 사용하여 경로를 계산할 도착 위치를 설정합니다.
setLanguage(language)DirectionFinder경로에 사용할 언어를 설정합니다.
setMode(mode)DirectionFinder이동 수단을 설정합니다 (기본값은 운전).
setOptimizeWaypoints(optimizeOrder)DirectionFinder경유지를 더 효율적인 순서로 재정렬하여 제공된 경로를 최적화할지 여부를 설정합니다 (기본값은 false).
setOrigin(latitude, longitude)DirectionFinder지점 (위도/경도)을 사용하여 경로를 계산할 시작 위치를 설정합니다.
setOrigin(address)DirectionFinder주소를 사용하여 경로를 계산할 출발지를 설정합니다.
setRegion(region)DirectionFinder위치 이름을 해석할 때 사용할 지역을 설정합니다.

DirectionFinderEnums

속성

속성유형설명
AvoidAvoid
ModeMode

ElevationSampler

방법

메서드반환 유형간략한 설명
sampleLocation(latitude, longitude)Object단일 지점 (위도/경도)에 대한 고도 데이터를 반환합니다.
sampleLocations(points)Object일련의 지점 (위도/경도)에 대한 고도 데이터를 반환합니다.
sampleLocations(encodedPolyline)Object인코딩된 폴리라인의 점에 대한 고도 데이터를 반환합니다.
samplePath(points, numSamples)Object일련의 점을 사용하여 정의된 선을 따라 여러 샘플의 고도 데이터를 반환합니다.
samplePath(encodedPolyline, numSamples)Object인코딩된 폴리라인을 사용하여 정의된 선을 따라 여러 샘플의 고도 데이터를 반환합니다.

Format

속성

속성유형설명
PNGEnum8비트 PNG 형식입니다.
PNG8Enum8비트 PNG 형식입니다.
PNG32Enum32비트 PNG 형식입니다.
GIFEnumGIF 형식입니다.
JPGEnumJPEG 형식.
JPG_BASELINEEnum비 프로그레시브 JPEG 형식입니다.

Geocoder

방법

메서드반환 유형간략한 설명
geocode(address)Object지정된 주소의 대략적인 지리적 지점을 가져옵니다.
reverseGeocode(latitude, longitude)Object지정된 지리적 지점의 대략적인 주소를 가져옵니다.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)Geocoder결과에 추가 환경설정을 지정해야 하는 영역의 경계를 설정합니다.
setLanguage(language)Geocoder결과에 사용할 언어를 설정합니다.
setRegion(region)Geocoder위치 이름을 해석할 때 사용할 지역을 설정합니다.

Maps

속성

속성유형설명
DirectionFinderDirectionFinderEnums
StaticMapStaticMapEnums

방법

메서드반환 유형간략한 설명
decodePolyline(polyline)Number[]인코딩된 폴리라인 문자열을 점의 배열로 다시 디코딩합니다.
encodePolyline(points)String점 배열을 문자열로 인코딩합니다.
newDirectionFinder()DirectionFinder새 DirectionFinder 객체를 만듭니다.
newElevationSampler()ElevationSamplerElevationSampler 객체를 만듭니다.
newGeocoder()Geocoder새 Geocoder 객체를 만듭니다.
newStaticMap()StaticMap새 StaticMap 객체를 만듭니다.
setAuthentication(clientId, signingKey)void외부에서 설정한 Google 지도 API 프리미엄 플랜 계정을 사용하여 추가 할당량 허용을 활용할 수 있습니다.

MarkerSize

속성

속성유형설명
TINYEnum규모가 작은 시장 (가장 작은 규모의 시장)
MIDEnum중간 크기의 마커 (최대 크기)
SMALLEnum작은 크기의 마커

Mode

속성

속성유형설명
DRIVINGEnum도로를 경유하는 운전 경로
WALKINGEnum보행자 전용 도로와 인도를 경유하는 도보 경로 (제공되는 경우)
BICYCLINGEnum자전거 전용 도로와 선호하는 거리를 경유하는 자전거 경로 (있는 경우)입니다.
TRANSITEnum대중교통 경로를 경유하는 대중교통 경로입니다 (제공되는 경우).

StaticMap

방법

메서드반환 유형간략한 설명
addAddress(address)StaticMap현재 경로 정의에 새 주소를 추가합니다.
addMarker(latitude, longitude)StaticMap점 (위도/경도)을 사용하여 지도에 마커를 추가합니다.
addMarker(address)StaticMap주소를 사용하여 지도에 마커를 추가합니다.
addPath(points)StaticMap점의 배열을 사용하여 지도에 경로를 추가합니다.
addPath(polyline)StaticMap인코딩된 폴리라인을 사용하여 지도에 경로를 추가합니다.
addPoint(latitude, longitude)StaticMap현재 경로 정의에 새 점 (위도/경도)을 추가합니다.
addVisible(latitude, longitude)StaticMap지도에 표시해야 하는 점 (위도/경도) 위치를 추가합니다.
addVisible(address)StaticMap지도에 표시되어야 하는 주소 위치를 추가합니다.
beginPath()StaticMap새 경로 정의를 시작합니다.
clearMarkers()StaticMap현재 마커 집합을 지웁니다.
clearPaths()StaticMap현재 경로 집합을 지웁니다.
clearVisibles()StaticMap현재 표시된 위치 집합을 지웁니다.
endPath()StaticMapstartPath()로 시작된 경로 정의를 완료합니다.
getAs(contentType)Blob이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다.
getBlob()Blob이미지 데이터를 Blob로 가져옵니다.
getMapImage()Byte[]원시 이미지 데이터를 바이트 배열로 가져옵니다.
getMapUrl()String지도 이미지의 URL을 가져옵니다.
setCenter(latitude, longitude)StaticMap점 (위도/경도)을 사용하여 지도의 중심을 설정합니다.
setCenter(address)StaticMap주소를 사용하여 지도의 중심을 설정합니다.
setCustomMarkerStyle(imageUrl, useShadow)StaticMap새 마커를 만들 때 사용할 맞춤 마커 이미지를 설정합니다.
setFormat(format)StaticMap지도 이미지의 형식을 설정합니다.
setLanguage(language)StaticMap지도에서 텍스트에 사용할 언어를 설정합니다 (avaialbe인 경우).
setMapType(mapType)StaticMap표시할 지도 유형을 설정합니다.
setMarkerStyle(size, color, label)StaticMap새 마커를 만들 때 사용할 마커 스타일을 설정합니다.
setMobile(useMobileTiles)StaticMap휴대기기에 특수 타일 집합을 사용할지 여부를 설정합니다.
setPathStyle(weight, color, fillColor)StaticMap새 경로를 만들 때 사용할 경로 스타일을 설정합니다.
setSize(width, height)StaticMap지도 이미지의 너비와 높이를 픽셀 단위로 설정합니다.
setZoom(zoom)StaticMap지도에 사용되는 확대/축소 비율 또는 확대 수준을 설정합니다.

StaticMapEnums

속성

속성유형설명
ColorColor
FormatFormat
MarkerSizeMarkerSize
TypeType

Type

속성

속성유형설명
ROADMAPEnumGoogle 지도 웹사이트에 일반적으로 표시되는 표준 로드맵입니다.
SATELLITEEnum위성 지도입니다.
TERRAINEnum지형과 초목이 표시된 실제 입체 지도
HYBRIDEnum위성 지도에 주요 거리 및 장소 이름의 투명한 레이어를 표시하는 위성 지도와 로드맵 지도의 하이브리드입니다.