정적 지도 이미지를 생성하고 꾸밀 수 있습니다.
아래 예에서는 이 클래스를 사용하여 인근 기차역을 포함한 뉴욕시 극장 지구의 지도를 만들고 간단한 웹 앱에 표시하는 방법을 보여줍니다.
// Create a map centered on Times Square. const 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. const 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 (let i = 0; i < corners.length; i++) { map.addAddress(corners[i]); } // All static map URLs require an API key. const url = `${map.getMapUrl()}&key=YOUR_API_KEY`;
참고 항목
메서드
| 메서드 | 반환 유형 | 간략한 설명 |
|---|---|---|
add | Static | 현재 경로 정의에 새 주소를 추가합니다. |
add | Static | 점을 사용하여 지도에 마커를 추가합니다 (위도/경도). |
add | Static | 주소를 사용하여 지도에 마커를 추가합니다. |
add | Static | 점 배열을 사용하여 지도에 경로를 추가합니다. |
add | Static | 인코딩된 폴리라인을 사용하여 지도에 경로를 추가합니다. |
add | Static | 현재 경로 정의에 새 포인트 (위도/경도)를 추가합니다. |
add | Static | 지도에 표시되어야 하는 포인트 (위도/경도) 위치를 추가합니다. |
add | Static | 지도에 표시되어야 하는 주소 위치를 추가합니다. |
begin | Static | 새 경로 정의를 시작합니다. |
clear | Static | 현재 마커 집합을 지웁니다. |
clear | Static | 현재 경로 집합을 지웁니다. |
clear | Static | 현재 표시되는 위치 집합을 지웁니다. |
end | Static | beginPath()로 시작된 경로 정의를 완료합니다. |
get | Blob | 이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다. |
get | Blob | 이미지 데이터를 Blob로 가져옵니다. |
get | Byte[] | 원시 이미지 데이터를 바이트 배열로 가져옵니다. |
get | String | 지도 이미지의 URL을 가져옵니다. |
set | Static | 점을 사용하여 지도 중심을 설정합니다 (위도/경도). |
set | Static | 주소를 사용하여 지도의 중심을 설정합니다. |
set | Static | 새 마커를 만들 때 사용할 맞춤 마커 이미지를 설정합니다. |
set | Static | 지도 이미지의 형식을 설정합니다. |
set | Static | 지도에 표시되는 텍스트에 사용할 언어를 설정합니다 (사용 가능한 경우). |
set | Static | 표시할 지도 유형을 설정합니다. |
set | Static | 새 마커를 만들 때 사용할 마커 스타일을 설정합니다. |
set | Static | 휴대기기에 특화된 타일 세트를 사용할지 여부를 설정합니다. |
set | Static | 새 경로를 만들 때 사용할 경로 스타일을 설정합니다. |
set | Static | 지도 이미지의 너비와 높이를 픽셀 단위로 설정합니다. |
set | Static | 지도에 사용되는 확대/축소 비율 또는 배율을 설정합니다. |
자세한 문서
add Address(address)
현재 경로 정의에 새 주소를 추가합니다.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
address | String | 추가할 주소입니다. |
리턴
Static: 이 지도 인스턴스(체이닝용)
add Marker(latitude, longitude)
점을 사용하여 지도에 마커를 추가합니다 (위도/경도).
// Creates a map and adds a marker at the specified coordinates. const map = Maps.newStaticMap().addMarker(40.741799, -74.004207);
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
latitude | Number | 새 마커의 위도입니다. |
longitude | Number | 새 마커의 경도입니다. |
리턴
Static: 이 지도 인스턴스(체이닝용)
참고 항목
add Marker(address)
주소를 사용하여 지도에 마커를 추가합니다.
// Creates a map and adds a marker at the specified address. const map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
address | String | 새 마커를 배치할 주소입니다. |
리턴
Static: 이 지도 인스턴스(체이닝용)
참고 항목
add Path(points)
점 배열을 사용하여 지도에 경로를 추가합니다.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap().addPath([ 40.714353, -74.005973, 42.358431, -71.059773, ]);
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
points | Number[] | 경로를 정의하는 위도/경도 쌍의 배열입니다. |
리턴
Static: 이 지도 인스턴스(체이닝용)
add Path(polyline)
인코딩된 폴리라인을 사용하여 지도에 경로를 추가합니다.
// Creates a map and adds a path from New York to Boston. const polyline = Maps.encodePolyline([ 40.714353, -74.005973, 42.358431, -71.059773, ]); const map = Maps.newStaticMap().addPath(polyline);
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
polyline | String | 인코딩된 다중선입니다. |
리턴
Static: 이 지도 인스턴스(체이닝용)
add Point(latitude, longitude)
현재 경로 정의에 새 포인트 (위도/경도)를 추가합니다.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addPoint(40.714353, -74.005973) .addPoint(42.358431, -71.059773) .endPath();
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
latitude | Number | 포인트의 위도입니다. |
longitude | Number | 포인트의 경도입니다. |
리턴
Static: 이 지도 인스턴스(체이닝용)
add Visible(latitude, longitude)
지도에 표시되어야 하는 포인트 (위도/경도) 위치를 추가합니다.
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap() .addVisible(40.714353, -74.005973) .addVisible(42.358431, -71.059773);
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
latitude | Number | 포인트의 위도입니다. |
longitude | Number | 포인트의 경도입니다. |
리턴
Static: 이 지도 인스턴스(체이닝용)
참고 항목
add Visible(address)
지도에 표시되어야 하는 주소 위치를 추가합니다.
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap().addVisible('New York, NY').addVisible('Boston, MA');
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
address | String | 지도에 표시되어야 하는 주소입니다. |
리턴
Static: 이 지도 인스턴스(체이닝용)
참고 항목
begin Path()
새 경로 정의를 시작합니다. add 및 add 호출은 경로의 각 새 꼭짓점을 정의합니다. end가 호출되면 경로가 완료됩니다.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
리턴
Static: 이 지도 인스턴스(체이닝용)
clear Markers()
현재 마커 집합을 지웁니다.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all markers on the map. map.clearMarkers();
리턴
Static: 이 지도 인스턴스(체이닝용)
clear Paths()
현재 경로 집합을 지웁니다.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
리턴
Static: 이 지도 인스턴스(체이닝용)
clear Visibles()
현재 표시되는 위치 집합을 지웁니다.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all visible locations created with addVisible(). map.clearVisibles();
리턴
Static: 이 지도 인스턴스(체이닝용)
end Path()
beginPath()로 시작된 경로 정의를 완료합니다.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
리턴
Static: 이 지도 인스턴스(체이닝용)
get As(contentType)
이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다. 이 메서드는 파일 이름에 적절한 확장자(예: 'myfile.pdf')를 추가합니다. 하지만 마지막 마침표 뒤에 오는 파일 이름 부분이 대체해야 하는 기존 확장 프로그램이라고 가정합니다. 따라서 'ShoppingList.12.25.2014'는 'ShoppingList.12.25.pdf'가 됩니다.
전환의 일일 할당량을 보려면 Google 서비스 할당량을 참고하세요. 새로 생성된 Google Workspace 도메인에는 일시적으로 더 엄격한 할당량이 적용될 수 있습니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
content | String | 변환할 MIME 유형입니다. 대부분의 블롭의 경우 'application/pdf'이 유일한 유효한 옵션입니다. BMP, GIF, JPEG 또는 PNG 형식의 이미지의 경우 'image/bmp', 'image/gif', 'image/jpeg' 또는 'image/png'도 유효합니다. Google Docs 문서의 경우 'text/markdown'도 유효합니다. |
리턴
Blob - 데이터를 blob으로 나타냅니다.
get Blob()
이미지 데이터를 Blob로 가져옵니다.
// Creates a map centered on Times Square and saves it to Google Drive. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); DriveApp.createFile(map); // You can call map.getBlob() explicitly or use it // implicitly by passing the map where a blob is expected.
리턴
Blob - 선택한 이미지 형식의 지도 이미지입니다.
get Map Image()
원시 이미지 데이터를 바이트 배열로 가져옵니다.
일반적으로 다른 서비스와의 상호작용을 더 간단하게 할 수 있는 get을 사용하는 것이 좋습니다.
// Creates a map centered on Times Square and saves it to Google Drive. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); DriveApp.createFile( Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'), );
리턴
Byte[] - 선택한 이미지 형식의 지도 이미지입니다.
get Map Url()
지도 이미지의 URL을 가져옵니다.
// Creates a map centered on Times Square and gets the URL. const 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입니다.
set Center(latitude, longitude)
점을 사용하여 지도 중심을 설정합니다 (위도/경도).
// Creates a map centered on Times Square, using its coordinates. const map = Maps.newStaticMap().setCenter(40.759011, -73.984472);
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
latitude | Number | 중심의 위도입니다. |
longitude | Number | 중심의 경도입니다. |
리턴
Static: 이 지도 인스턴스(체이닝용)
참고 항목
set Center(address)
주소를 사용하여 지도의 중심을 설정합니다.
// Creates a map centered on Times Square, using its address. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
address | String | 센터의 주소입니다. |
리턴
Static: 이 지도 인스턴스(체이닝용)
참고 항목
set Custom Marker Style(imageUrl, useShadow)
새 마커를 만들 때 사용할 맞춤 마커 이미지를 설정합니다. 이미 추가된 마커는 영향을 받지 않습니다.
// Creates a map with markers set to be medium sized, black, and labeled with // the number "1". const map = Maps.newStaticMap().setCustomMarkerStyle( 'http://www.example.com/marker.png', false, );
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
image | String | 마커의 맞춤 아이콘으로 사용할 URL을 지정합니다. 이미지는 PNG, JPEG 또는 GIF 형식일 수 있지만 PNG가 권장됩니다. |
use | Boolean | 마커에 이미지의 표시 영역과 불투명도/투명도를 기반으로 생성된 그림자가 있어야 함을 나타냅니다. |
리턴
Static: 이 지도 인스턴스(체이닝용)
참고 항목
set Format(format)
set Language(language)
지도에 표시되는 텍스트에 사용할 언어를 설정합니다 (사용 가능한 경우).
// Creates a map with the language set to French. const map = Maps.newStaticMap().setLanguage('fr');
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
language | String | BCP-47 언어 식별자입니다. |
리턴
Static: 이 지도 인스턴스(체이닝용)
참고 항목
set Map Type(mapType)
set Marker Style(size, color, label)
새 마커를 만들 때 사용할 마커 스타일을 설정합니다. 이미 추가된 마커는 영향을 받지 않습니다.
// Creates a map with markers set to be medium sized, black, and labeled with // the number "1". const map = Maps.newStaticMap().setMarkerStyle( Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.BLACK, '1', );
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
size | String | Marker의 상수 값입니다. |
color | String | '0xrrggbb' 형식의 문자열 또는 Color의 상수 값입니다. |
label | String | 단일 문자 A~Z 또는 0~9가 포함된 문자열입니다. |
리턴
Static: 이 지도 인스턴스(체이닝용)
참고 항목
set Mobile(useMobileTiles)
휴대기기에 특화된 타일 세트를 사용할지 여부를 설정합니다.
// Creates a map that uses mobile-friendly tiles. const map = Maps.newStaticMap().setMobile(true);
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
use | Boolean | 모바일 타일 사용 여부입니다. |
리턴
Static: 이 지도 인스턴스(체이닝용)
set Path Style(weight, color, fillColor)
새 경로를 만들 때 사용할 경로 스타일을 설정합니다. 이미 추가된 경로는 영향을 받지 않습니다.
// Creates a map with paths set to be 1 pixel wide with a black line and a white // fill. const map = Maps.newStaticMap().setPathStyle( 1, Maps.StaticMap.Color.BLACK, 'red', );
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
weight | Integer | 선의 너비(픽셀)입니다. |
color | String | 선의 색상으로, '0xrrggbb' 형식의 문자열이나 Color의 상수 값입니다. |
fill | String | 채우기 색상으로, '0xrrggbb' 형식의 문자열 또는 Color의 상수 값입니다. |
리턴
Static: 이 지도 인스턴스(체이닝용)
참고 항목
set Size(width, height)
지도 이미지의 너비와 높이를 픽셀 단위로 설정합니다.
// Creates a map 400px wide by 300px high. const map = Maps.newStaticMap().setSize(400, 300);
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
width | Integer | 이미지 너비(픽셀 단위)입니다. |
height | Integer | 이미지 높이(픽셀 단위)입니다. |
리턴
Static: 이 지도 인스턴스(체이닝용)
참고 항목
set Zoom(zoom)
지도에 사용되는 확대/축소 비율 또는 배율을 설정합니다.
// Creates a map with a zoom factor of 10. const map = Maps.newStaticMap().setZoom(10);
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
zoom | Integer | 0~21 범위의 값입니다. |
리턴
Static: 이 지도 인스턴스(체이닝용)