Maps Service

지도

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

클래스

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

Avoid

속성

속성유형설명
TOLLSEnum유료도로 이용 안함
HIGHWAYSEnum고속도로를 피하세요.

Color

속성

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

DirectionFinder

메서드

메서드반환 유형간략한 설명
addWaypoint(latitude, longitude)DirectionFinder지점 (lat/lng)을 사용하여 경로가 통과해야 하는 경로 지점을 추가합니다.
addWaypoint(address)DirectionFinder주소를 사용하여 경로가 통과해야 하는 중간 지점을 추가합니다.
clearWaypoints()DirectionFinder현재 웨이포인트 세트를 지웁니다.
getDirections()Object출발지, 도착지, 설정된 기타 옵션을 사용하여 경로를 가져옵니다.
setAlternatives(useAlternatives)DirectionFinder순위가 가장 높은 경로만 반환하는 대신 대체 경로를 반환할지 여부를 설정합니다 (기본값은 false).
setArrive(time)DirectionFinder원하는 도착 시간을 설정합니다 (해당하는 경우).
setAvoid(avoid)DirectionFinder특정 유형의 제한을 피할지 여부를 설정합니다.
setDepart(time)DirectionFinder원하는 출발 시간을 설정합니다 (해당하는 경우).
setDestination(latitude, longitude)DirectionFinder지점 (lat/lng)을 사용하여 경로를 계산할 종료 위치를 설정합니다.
setDestination(address)DirectionFinder주소를 사용하여 경로를 계산할 종료 위치를 설정합니다.
setLanguage(language)DirectionFinder경로에 사용할 언어를 설정합니다.
setMode(mode)DirectionFinder이동 수단을 설정합니다 (기본값: 운전).
setOptimizeWaypoints(optimizeOrder)DirectionFinder더 효율적인 순서로 경유지를 재정렬하여 제공된 경로를 최적화할지 여부를 설정합니다 (기본값: false).
setOrigin(latitude, longitude)DirectionFinder지점 (lat/lng)을 사용하여 경로를 계산할 시작 위치를 설정합니다.
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점 (lat/lng)을 사용하여 지도에 마커를 추가합니다.
addMarker(address)StaticMap주소를 사용하여 지도에 마커를 추가합니다.
addPath(points)StaticMap점 배열을 사용하여 지도에 경로를 추가합니다.
addPath(polyline)StaticMap인코딩된 다중선을 사용하여 지도에 경로를 추가합니다.
addPoint(latitude, longitude)StaticMap현재 경로 정의에 새 지점 (lat/lng)을 추가합니다.
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위성 지도와 도로지도를 혼합하여 지정하며, 주요 거리와 장소 이름의 투명 계층을 위성 지도 위에 표시합니다.