Class StaticMap

StaticMap

静的な地図画像の作成と装飾が可能になります。

以下の例は、このクラスを使用してニューヨーク市の劇場の地図を作成する方法を示しています。 近隣の駅を含む地区。シンプルなウェブアプリで表示できます。

// 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 Static Maps 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	beginPath() で始まるパスの定義を完了します。
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 Static Maps 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 Static Maps 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 Static Maps 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 Static Maps 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()

beginPath() で始まるパスの定義を完了します。

// 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」

コンバージョンの 1 日あたりの割り当てを確認するには、Google Cloud の割り当て サービス。新しく作成された Google Workspace ドメインには一時的に厳格な できます。

パラメータ

名前	型	説明
contentType	String	変換先の MIME タイプ。ほとんどの blob の場合、'application/pdf' は次のようになります。 唯一の有効な選択肢となりますBMP、GIF、JPEG、PNG 形式の画像の場合は、'image/bmp'、'image/gif'、'image/jpeg'、'image/png' のいずれかも可 有効です。Google ドキュメントのドキュメントの場合は、'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 Static Maps 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 Static Maps 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 Static Maps 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 Static Maps 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 Maps API での言語サポート

---

setMapType(mapType)

表示する地図のタイプを設定します。

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

パラメータ

名前	型	説明
mapType	String	Type の定数値。

戻る

StaticMap - チェーン用のこのマップ インスタンス。

関連情報

• Google Static Maps 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	1 文字の A ～ Z または 0 ～ 9 を含む文字列。

戻る

StaticMap - チェーン用のこのマップ インスタンス。

関連情報

• Google Static Maps 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 Static Maps 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 Static Maps API

---

setZoom(zoom)

地図に使用されるズーム倍率または拡大レベルを設定します。

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

パラメータ

名前	型	説明
zoom	Integer	0 ～ 21 の値（両端を含む）。

戻る

StaticMap - チェーン用のこのマップ インスタンス。

関連情報

• Google Static Maps API