정적 지도 이미지를 만들고 장식할 수 있습니다.
아래 예에서는 이 클래스를 사용하여 인근 기차역을 포함하여 뉴욕시의 극장 지구 지도를 만들고 간단한 웹 앱에 표시하는 방법을 보여줍니다.
// 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 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)
점 (lat/lng)을 사용하여 지도에 마커를 추가합니다.
// 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)
현재 경로 정의에 새 지점 (lat/lng)을 추가합니다.
// 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 유형입니다. 대부분의 blob의 경우 '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
: 체이닝에 이 맵 인스턴스가 반환됩니다.