Class StaticMap

静的地図画像の作成と装飾を可能にします。

次の例は、このクラスを使用して、ニューヨーク市の劇場街とその周辺の鉄道駅の地図を作成し、シンプルなウェブアプリに表示する方法を示しています。

// 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`;

メソッド

メソッド	戻り値の型	概要
`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[]`	RAW 画像データをバイト配列として取得します。
`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`	地図に使用するズーム率（拡大率）を設定します。

詳細なドキュメント

`addAddress(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`	追加するアドレス。

戻る

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

`addMarker(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`	新しいマーカーの経度。

戻る

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

`addMarker(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`	新しいマーカーを配置するアドレス。

戻る

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

`addPath(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[]`	パスを定義する緯度と経度のペアの配列。

戻る

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

`addPath(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`	エンコードされたポリライン。

戻る

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

`addPoint(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`	ポイントの経度。

戻る

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

`addVisible(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`	ポイントの経度。

戻る

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

`addVisible(address)`

地図に表示する必要がある住所の位置を追加します。

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

パラメータ

名前	型	説明
`address`	`String`	地図に表示する必要がある住所。

戻る

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

`beginPath()`

新しいパス定義を開始します。addAddress() と addPoint() の呼び出しは、パス内の新しい頂点を定義します。endPath() が呼び出されると、パスが完了します。

// 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();

戻る

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

`clearMarkers()`

現在のマーカーのセットをクリアします。

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

戻る

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

`clearPaths()`

現在のパスのセットをクリアします。

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

戻る

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

`clearVisibles()`

現在表示されている位置情報のセットをクリアします。

const 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.
const 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 サービスの割り当てをご覧ください。新しく作成された 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.
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 - 選択した画像形式の地図の画像。

`getMapImage()`

RAW 画像データをバイト配列として取得します。

一般に、他のサービスとのやり取りを簡素化できる getBlob() の使用が推奨されます。

// 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[] - 選択した画像形式の地図の画像。

`getMapUrl()`

地図画像の 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。

`setCenter(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`	中心の経度。

戻る

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

`setCenter(address)`

住所を使用して地図の中心を設定します。

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

パラメータ

名前	型	説明
`address`	`String`	センターの住所。

戻る

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

`setCustomMarkerStyle(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,
);

パラメータ

名前	型	説明
`imageUrl`	`String`	マーカーのカスタムアイコンとして使用する URL を指定します。画像の形式は PNG、JPEG、GIF のいずれかにしてください（PNG を推奨）。
`useShadow`	`Boolean`	マーカーの表示領域と不透明度/透明度に基づいて、マーカーに影を生成する必要があることを示します。

戻る

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

`setFormat(format)`

地図画像の形式を設定します。

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

パラメータ

名前	型	説明
`format`	`String`	`Format` の定数値。

戻る

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

`setLanguage(language)`

地図上のテキストに使用する言語を設定します（利用可能な場合）。

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

パラメータ

名前	型	説明
`language`	`String`	BCP-47 言語識別子。

戻る

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

`setMapType(mapType)`

表示する地図の種類を設定します。

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

パラメータ

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

戻る

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

`setMarkerStyle(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`	`MarkerSize` の定数値。
`color`	`String`	「0xrrggbb」形式の文字列、または `Color` の定数値。
`label`	`String`	A ～ Z または 0 ～ 9 の 1 文字を含む文字列。

戻る

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

`setMobile(useMobileTiles)`

モバイルデバイス用の専用タイルセットを使用するかどうかを設定します。

// Creates a map that uses mobile-friendly tiles.
const 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.
const map = Maps.newStaticMap().setPathStyle(
    1,
    Maps.StaticMap.Color.BLACK,
    'red',
);

パラメータ

名前	型	説明
`weight`	`Integer`	線の幅（ピクセル単位）。
`color`	`String`	線の色。文字列（「0xrrggbb」形式）または `Color` の定数値で指定します。
`fillColor`	`String`	塗りつぶしの色。形式「0xrrggbb」の文字列、または `Color` の定数値。

戻る

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

`setSize(width, height)`

地図画像の幅と高さをピクセル単位で設定します。

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

パラメータ

名前	型	説明
`width`	`Integer`	画像の幅（ピクセル単位）。
`height`	`Integer`	画像の高さ（ピクセル単位）。

戻る

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

`setZoom(zoom)`

地図に使用するズームファクタ（拡大率）を設定します。

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

パラメータ

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

戻る

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

Class StaticMap コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

関連情報

メソッド

詳細なドキュメント

addAddress(address)

パラメータ

戻る

addMarker(latitude, longitude)

パラメータ

戻る

関連情報

addMarker(address)

パラメータ

戻る

関連情報

addPath(points)

パラメータ

戻る

addPath(polyline)

パラメータ

戻る

addPoint(latitude, longitude)

パラメータ

戻る

addVisible(latitude, longitude)

パラメータ

戻る

関連情報

addVisible(address)

パラメータ

戻る

関連情報

beginPath()

戻る

clearMarkers()

戻る

clearPaths()

戻る

clearVisibles()

戻る

endPath()

戻る

getAs(contentType)

パラメータ

戻る

getBlob()

戻る

getMapImage()

戻る

getMapUrl()

戻る

setCenter(latitude, longitude)

パラメータ

戻る

関連情報

setCenter(address)

パラメータ

戻る

関連情報

setCustomMarkerStyle(imageUrl, useShadow)

パラメータ

戻る

関連情報

setFormat(format)

パラメータ

戻る

関連情報

setLanguage(language)

パラメータ

戻る

関連情報

setMapType(mapType)

パラメータ

戻る

関連情報

setMarkerStyle(size, color, label)

パラメータ

戻る

関連情報

setMobile(useMobileTiles)

Class StaticMap

`addAddress(address)`

`addMarker(latitude, longitude)`

`addMarker(address)`

`addPath(points)`

`addPath(polyline)`

`addPoint(latitude, longitude)`

`addVisible(latitude, longitude)`

`addVisible(address)`

`beginPath()`

`clearMarkers()`

`clearPaths()`

`clearVisibles()`

`endPath()`

`getAs(contentType)`

`getBlob()`

`getMapImage()`

`getMapUrl()`

`setCenter(latitude, longitude)`

`setCenter(address)`

`setCustomMarkerStyle(imageUrl, useShadow)`

`setFormat(format)`

`setLanguage(language)`

`setMapType(mapType)`

`setMarkerStyle(size, color, label)`

`setMobile(useMobileTiles)`

`setPathStyle(weight, color, fillColor)`

`setSize(width, height)`

`setZoom(zoom)`