このページは Cloud Translation API によって翻訳されました。

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[]`	未加工の画像データをバイト配列として取得します。
`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」になります。

コンバージョンの日別割り当てを表示するには、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()`

未加工の画像データをバイト配列として取得します。

一般的には、他のサービスとのやり取りを簡単にできる 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)

`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)`