Class StaticMap

StaticMap

정적 지도 이미지를 만들고 장식할 수 있습니다.

아래 예는 이 클래스를 사용하여 New York City's Theatre의 지도를 만드는 방법을 보여줍니다. 지역, 주변 기차역이 포함된 지도를 표시하고 간단한 웹 앱에 표시합니다.

// Create a map centered on Times Square.
var map = Maps.newStaticMap()
    .setSize(600, 600)
    .setCenter('Times Square, New York, NY');

// Add markers for the nearbye train stations.
map.setMarkerStyle(Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.RED, 'T');
map.addMarker('Grand Central Station, New York, NY');
map.addMarker('Penn Station, New York, NY');

// Show the boundaries of the Theatre District.
var corners = [
  '8th Ave & 53rd St, New York, NY',
  '6th Ave & 53rd St, New York, NY',
  '6th Ave & 40th St, New York, NY',
  '8th Ave & 40th St, New York, NY'
];
map.setPathStyle(4, Maps.StaticMap.Color.BLACK, Maps.StaticMap.Color.BLUE);
map.beginPath();
for (var i = 0; i < corners.length; i++) {
  map.addAddress(corners[i]);
}
// All static map URLs require an API key.
var url = map.getMapUrl() + "&key=YOUR_API_KEY";

참고 항목

• Google 정적 지도 API

메서드

메서드	반환 유형	간략한 설명
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()	StaticMap	startPath()로 시작하는 경로 정의를 완성합니다.
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	지도에 사용되는 확대/축소 비율 또는 확대 수준을 설정합니다.

자세한 문서

addAddress(address)

현재 경로 정의에 새 주소를 추가합니다.

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

매개변수

이름	유형	설명
address	String	추가할 주소입니다.

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

---

addMarker(latitude, longitude)

점 (위도/경도)을 사용하여 지도에 마커를 추가합니다.

// Creates a map and adds a marker at the specified coordinates.
var map = Maps.newStaticMap().addMarker(40.741799, -74.004207);

매개변수

이름	유형	설명
latitude	Number	새 마커의 위도입니다.
longitude	Number	새 마커의 경도입니다.

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

참고 항목

• Google 정적 지도 API

---

addMarker(address)

주소를 사용하여 지도에 마커를 추가합니다.

// Creates a map and adds a marker at the specified address.
var map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');

매개변수

이름	유형	설명
address	String	새 마커를 배치할 의 주소입니다.

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

참고 항목

• Google 정적 지도 API

---

addPath(points)

점의 배열을 사용하여 지도에 경로를 추가합니다.

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .addPath([40.714353, -74.005973, 42.358431, -71.059773]);

매개변수

이름	유형	설명
points	Number[]	경로를 정의하는 위도/경도 쌍의 배열입니다.

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

---

addPath(polyline)

인코딩된 폴리라인을 사용하여 지도에 경로를 추가합니다.

// Creates a map and adds a path from New York to Boston.
var polyline = Maps.encodePolyline([40.714353, -74.005973, 42.358431, -71.059773]);
var map = Maps.newStaticMap().addPath(polyline);

매개변수

이름	유형	설명
polyline	String	인코딩된 폴리라인입니다.

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

---

addPoint(latitude, longitude)

현재 경로 정의에 새 점 (위도/경도)을 추가합니다.

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .beginPath()
    .addPoint(40.714353, -74.005973)
    .addPoint(42.358431, -71.059773)
    .endPath();

매개변수

이름	유형	설명
latitude	Number	점의 위도입니다.
longitude	Number	점의 경도입니다.

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

---

addVisible(latitude, longitude)

지도에 표시되어야 하는 점 (위도/경도) 위치를 추가합니다.

// Creates a map where New York and Boston are visible.
var map = Maps.newStaticMap()
    .addVisible(40.714353, -74.005973);
    .addVisible(42.358431, -71.059773)

매개변수

이름	유형	설명
latitude	Number	점의 위도입니다.
longitude	Number	점의 경도입니다.

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

참고 항목

• Google 정적 지도 API

---

addVisible(address)

지도에 표시되어야 하는 주소 위치를 추가합니다.

// Creates a map where New York and Boston are visible.
var map = Maps.newStaticMap()
    .addVisible('New York, NY')
    .addVisible('Boston, MA');

매개변수

이름	유형	설명
address	String	지도에 표시되어야 하는 주소입니다.

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

참고 항목

• Google 정적 지도 API

---

beginPath()

새 경로 정의를 시작합니다. addAddress() 및 addPoint() 호출이 각각을 정의합니다. 새 꼭짓점을 만들 수 있습니다. endPath()가 호출되면 경로가 완료됩니다.

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

---

clearMarkers()

현재 마커 집합을 지웁니다.

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all markers on the map.
map.clearMarkers();

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

---

clearPaths()

현재 경로 세트를 지웁니다.

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all paths on the map.
map.clearPaths();

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

---

clearVisibles()

현재 표시된 위치 집합을 지웁니다.

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all visible locations created with addVisible().
map.clearVisibles();

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

---

endPath()

startPath()로 시작하는 경로 정의를 완성합니다.

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

---

getAs(contentType)

이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다. 이 메서드는 파일 이름에 적절한 확장자를 추가합니다(예: 'myfile.pdf'). 하지만 파일 이름에서 마지막 마침표 뒤에 오는 부분 (있는 경우)이 기존 교체해야 합니다. 따라서 'ShoppingList.12.25.2014' 위 이름이 아래와 같이 변경됩니다. 'ShoppingList.12.25.pdf'

전환수의 일일 할당량을 보려면 Google '서비스'로 이동합니다. 새로 생성된 Google Workspace 도메인에는 일시적으로 더 엄격한 정책이 적용될 수 있습니다. 할당량도 제공합니다

매개변수

이름	유형	설명
contentType	String	변환할 MIME 유형입니다. 대부분의 blob에서 'application/pdf'는 다음과 같습니다. 유일하게 유효한 옵션입니다. BMP, GIF, JPEG, PNG 형식의 이미지인 경우 'image/bmp', 'image/gif', 'image/jpeg', 'image/png' 중 어느 것이든 해당됩니다. 유효한지 확인합니다. Google Docs 문서의 경우 'text/markdown'도 유효합니다.

리턴

Blob - blob 형식의 데이터입니다.

---

getBlob()

이미지 데이터를 Blob로 가져옵니다.

// Creates a map centered on Times Square and saves it to Google Drive.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
DocsList.createFile(map);  // You can call map.getBlob() explicitly or use it
                           // implicitly by passing the map where a blob is expected.

리턴

Blob - 선택한 이미지 형식의 지도 이미지입니다.

---

getMapImage()

원시 이미지 데이터를 바이트 배열로 가져옵니다.

일반적으로 다른 사용자와의 상호작용이 더 간단해지도록 getBlob()를 사용하는 것이 좋습니다. 제공합니다

// Creates a map centered on Times Square and saves it to Google Drive.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
DocsList.createFile(Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'));

리턴

Byte[] - 선택한 이미지 형식의 지도 이미지입니다.

---

getMapUrl()

지도 이미지의 URL을 가져옵니다.

// Creates a map centered on Times Square and gets the URL.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
// All static map URLs require an API key.
Logger.log(map.getMapUrl() + "&key=YOUR_API_KEY");

리턴

String - URL 지도 이미지 URL입니다.

---

setCenter(latitude, longitude)

점 (위도/경도)을 사용하여 지도의 중심을 설정합니다.

// Creates a map centered on Times Square, using its coordinates.
var map = Maps.newStaticMap().setCenter(40.759011, -73.984472);

매개변수

이름	유형	설명
latitude	Number	중심의 위도입니다.
longitude	Number	중앙의 경도입니다.

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

참고 항목

• Google 정적 지도 API

---

setCenter(address)

주소를 사용하여 지도의 중심을 설정합니다.

// Creates a map centered on Times Square, using its address.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');

매개변수

이름	유형	설명
address	String	센터의 주소입니다.

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

참고 항목

• Google 정적 지도 API

---

setCustomMarkerStyle(imageUrl, useShadow)

새 마커를 만들 때 사용할 맞춤 마커 이미지를 설정합니다. 이전에 만든 마커는 영향을 받지 않습니다.

// Creates a map with markers set to be medium sized, black, and labeled with the number "1".
var map = Maps.newStaticMap()
    .setCustomMarkerStyle('http://www.example.com/marker.png', false);

매개변수

이름	유형	설명
imageUrl	String	마커의 맞춤형 아이콘으로 사용할 URL을 지정합니다. 이미지는 PNG, JPEG 형식일 수 있습니다. 또는 GIF 형식을 사용할 수 있지만 PNG를 권장합니다.
useShadow	Boolean	이미지의 크기를 기반으로 마커에 그림자가 생성되어야 함을 나타냅니다. 해당 영역과 불투명도/투명도를 설정할 수 있습니다.

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

참고 항목

• Google 정적 지도 API

---

setFormat(format)

지도 이미지의 형식을 설정합니다.

// Creates a map with the image format set to PNG.
var map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);

매개변수

이름	유형	설명
format	String	Format의 상수 값입니다.

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

참고 항목

• Google 정적 지도 API

---

setLanguage(language)

지도의 텍스트에 사용할 언어를 설정합니다 (avaialbe).

// Creates a map with the language set to French.
var map = Maps.newStaticMap().setLanguage('fr');

매개변수

이름	유형	설명
language	String	BCP-47 언어 식별자입니다.

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

참고 항목

• Google 지도 API의 언어 지원

---

setMapType(mapType)

표시할 지도의 유형을 설정합니다.

// Creates a satellite map.
var map = Maps.newStaticMap().setMapType(Maps.StaticMap.Type.SATELLITE);

매개변수

이름	유형	설명
mapType	String	Type의 상수 값입니다.

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

참고 항목

• Google 정적 지도 API

---

setMarkerStyle(size, color, label)

새 마커를 만들 때 사용할 마커 스타일을 설정합니다. 이미 추가된 마커 영향을 받지 않습니다.

// Creates a map with markers set to be medium sized, black, and labeled with the number "1".
var map = Maps.newStaticMap()
    .setMarkerStyle(Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.BLACK , '1');

매개변수

이름	유형	설명
size	String	MarkerSize의 상수 값입니다.
color	String	'0xrrggbb' 형식의 문자열 또는 Color의 상수 값입니다.
label	String	단일 문자(A~Z 또는 0~9)를 포함하는 문자열입니다.

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

참고 항목

• Google 정적 지도 API

---

setMobile(useMobileTiles)

휴대기기에 특수한 타일 집합을 사용할지 여부를 설정합니다.

// Creates a map that uses mobile-friendly tiles.
var map = Maps.newStaticMap().setMobile(true);

매개변수

이름	유형	설명
useMobileTiles	Boolean	모바일 타일 사용 여부입니다.

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

---

setPathStyle(weight, color, fillColor)

새 경로를 만들 때 사용할 경로 스타일을 설정합니다. 이미 추가된 경로는 있습니다.

// Creates a map with paths set to be 1 pixel wide with a black line and a white fill.
var map = Maps.newStaticMap()
    .setPathStyle(1, Maps.StaticMap.Color.BLACK , 'red');

매개변수

이름	유형	설명
weight	Integer	선의 너비(픽셀)입니다.
color	String	'0xrrggbb' 형식의 문자열인 선 색상입니다. 또는 Color
fillColor	String	채우기 색상, '0xrrggbb' 형식의 문자열 또는 Color

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

참고 항목

• Google 정적 지도 API

---

setSize(width, height)

지도 이미지의 너비와 높이를 픽셀 단위로 설정합니다.

// Creates a map 400px wide by 300px high.
var map = Maps.newStaticMap().setSize(400, 300);

매개변수

이름	유형	설명
width	Integer	이미지 너비(픽셀 단위)입니다.
height	Integer	이미지 높이(픽셀 단위)입니다.

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

참고 항목

• Google 정적 지도 API

---

setZoom(zoom)

지도에 사용되는 확대/축소 비율 또는 확대 수준을 설정합니다.

// Creates a map with a zoom factor of 10.
var map = Maps.newStaticMap().setZoom(10);

매개변수

이름	유형	설명
zoom	Integer	0 이상 21 이하의 값입니다.

리턴

StaticMap - 체인을 위한 이 지도 인스턴스입니다.

참고 항목

• Google 정적 지도 API