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

Class 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";

メソッド

メソッド	戻り値の型	概要
`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 - チェーン用のこのマップインスタンス。

`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 - チェーン用のこのマップインスタンス。

`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 - チェーン用のこのマップインスタンス。

`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 - チェーン用のこのマップインスタンス。

`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 - チェーン用のこのマップインスタンス。

`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 - チェーン用のこのマップインスタンス。

`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 - チェーン用のこのマップインスタンス。

`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 - チェーン用のこのマップインスタンス。

`setLanguage(language)`

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

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

パラメータ

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

戻る

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

`setMapType(mapType)`

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

// Creates a satellite map.
var 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".
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 - チェーン用のこのマップインスタンス。

`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 - チェーン用のこのマップインスタンス。

`setSize(width, height)`

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

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

パラメータ

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

戻る

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

`setZoom(zoom)`

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

// Creates a map with a zoom factor of 10.
var 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)`