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()StaticMapbeginPath() で開始されたパス定義を完了します。
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();

パラメータ

名前説明
addressString追加する住所。

戻る

StaticMap - この地図インスタンス(チェーン用)。


addMarker(latitude, longitude)

地点(緯度/経度)を使用して地図にマーカーを追加します。

// Creates a map and adds a marker at the specified coordinates.
const map = Maps.newStaticMap().addMarker(40.741799, -74.004207);

パラメータ

名前説明
latitudeNumber新しいマーカーの緯度。
longitudeNumber新しいマーカーの緯度。

戻る

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');

パラメータ

名前説明
addressString新しいマーカーを配置する住所。

戻る

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,
]);

パラメータ

名前説明
pointsNumber[]パスを定義する緯度と経度のペアの配列。

戻る

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

パラメータ

名前説明
polylineStringエンコードされたポリライン。

戻る

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

パラメータ

名前説明
latitudeNumberポイントの緯度。
longitudeNumberポイントの経度。

戻る

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

パラメータ

名前説明
latitudeNumberポイントの緯度。
longitudeNumberポイントの経度。

戻る

StaticMap - この地図インスタンス(チェーン用)。

関連情報


addVisible(address)

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

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

パラメータ

名前説明
addressString地図に表示する必要がある住所。

戻る

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 ドメインには、一時的に厳しい割り当てが適用される場合があります。

パラメータ

名前説明
contentTypeString変換する 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);

パラメータ

名前説明
latitudeNumber中心の緯度。
longitudeNumber中心の経度。

戻る

StaticMap - この地図インスタンス(チェーン用)。

関連情報


setCenter(address)

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

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

パラメータ

名前説明
addressStringセンターの住所。

戻る

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,
);

パラメータ

名前説明
imageUrlStringマーカーのカスタム アイコンとして使用する URL を指定します。アイコンの画像は PNG、JPEG、GIF のいずれかの形式を使用できますが、PNG が推奨されています。
useShadowBoolean画像の可視部分とその不透明度/透明度に基づいて、マーカーにシャドウを生成することを示します。

戻る

StaticMap - この地図インスタンス(チェーン用)。

関連情報


setFormat(format)

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

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

パラメータ

名前説明
formatStringFormat の定数値。

戻る

StaticMap - この地図インスタンス(チェーン用)。

関連情報


setLanguage(language)

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

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

パラメータ

名前説明
languageStringBCP-47 言語識別子。

戻る

StaticMap - この地図インスタンス(チェーン用)。

関連情報


setMapType(mapType)

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

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

パラメータ

名前説明
mapTypeStringType の定数値。

戻る

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',
);

パラメータ

名前説明
sizeStringMarkerSize の定数値。
colorString「0xrrggbb」形式の文字列、または Color の定数値。
labelStringA ~ Z または 0 ~ 9 の 1 文字を含む文字列。

戻る

StaticMap - この地図インスタンス(チェーン用)。

関連情報


setMobile(useMobileTiles)

モバイル デバイス用に特別なタイルセットを使用するかどうかを設定します。

// Creates a map that uses mobile-friendly tiles.
const map = Maps.newStaticMap().setMobile(true);

パラメータ

名前説明
useMobileTilesBooleanモバイルタイルを利用するかどうか。

戻る

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',
);

パラメータ

名前説明
weightInteger線の幅(ピクセル単位)。
colorString線の色(「0xrrggbb」形式の文字列または Color の定数値)。
fillColorString塗りつぶし色(「0xrrggbb」形式の文字列、または Color の定数値)。

戻る

StaticMap - この地図インスタンス(チェーン用)。

関連情報


setSize(width, height)

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

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

パラメータ

名前説明
widthInteger画像の幅(ピクセル単位)。
heightInteger画像の高さ(ピクセル単位)。

戻る

StaticMap - この地図インスタンス(チェーン用)。

関連情報


setZoom(zoom)

地図に使用するズーム倍率(拡大レベル)を設定します。

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

パラメータ

名前説明
zoomInteger0 ~ 21 の値。

戻る

StaticMap - この地図インスタンス(チェーン用)。

関連情報