Maps Service

지도

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

클래스

이름간략한 설명
Avoid경로를 찾을 때 피해야 하는 제한사항 유형을 나타내는 열거형입니다.
Color지도 이미지에서 사용할 수 있는 명명된 색상을 나타내는 열거형입니다.
DirectionFinder위치 간 경로를 가져올 수 있습니다.
DirectionFinderEnumsDirectionFinder에서 사용하는 enum 모음입니다.
ElevationSampler특정 위치에서 고도를 샘플링할 수 있습니다.
Format지도 이미지의 형식을 나타내는 enum입니다.
Geocoder주소와 지리 좌표 간의 변환을 허용합니다.
Maps방향 찾기, 지오코딩, 고도 샘플링, 정적 지도 이미지 생성을 허용합니다.
MarkerSize지도에 추가된 마커의 크기를 나타내는 enum입니다.
Mode경로를 찾을 때 사용할 이동 모드를 나타내는 enum입니다.
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 객체를 만듭니다.
resetAuthenticationApiKey()void기본 할당량 허용량을 사용하도록 인증 사용자 인증 정보를 재설정합니다.
setAuthenticationByApiKey(apiKey)void추가 할당량을 활용하기 위해 API 키를 사용하여 요청을 인증할 수 있습니다.
setAuthenticationByApiKey(apiKey, signingKey)voidAPI 키와 서명 키를 사용하여 StaticMap에서 추가 할당량을 활용하기 위한 요청을 인증할 수 있습니다.

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()StaticMapbeginPath()로 시작된 경로 정의를 완료합니다.
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지도에 표시되는 텍스트에 사용할 언어를 설정합니다 (사용 가능한 경우).
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

속성

속성유형설명
ROADMAPEnum일반적으로 Google 지도 웹사이트에 표시되는 표준 로드맵입니다.
SATELLITEEnum위성 지도입니다.
TERRAINEnum지형과 식물을 보여주는 실제 지형도
HYBRIDEnum위성 지도와 로드맵 지도의 하이브리드 지도입니다. 위성 지도에 주요 도로와 장소 이름이 투명한 레이어로 표시됩니다.