Class Maps

マップ

経路検索、ジオコーディング、標高のサンプリング、静的地図画像の作成が可能です。

プロパティ

プロパティタイプ説明
DirectionFinderDirectionFinderEnums
StaticMapStaticMapEnums

メソッド

メソッド戻り値の型概要
decodePolyline(polyline)Number[]エンコードされたポリライン文字列をデコードして、ポイントの配列に戻します。
encodePolyline(points)Stringポイントの配列を文字列にエンコードします。
newDirectionFinder()DirectionFinder新しい DirectionFinder オブジェクトを作成します。
newElevationSampler()ElevationSamplerElevationSampler オブジェクトを作成します。
newGeocoder()Geocoder新しい Geocoder オブジェクトを作成します。
newStaticMap()StaticMap新しい StaticMap オブジェクトを作成します。
resetAuthenticationApiKey()void認証情報をリセットして、デフォルトの割り当て制限を使用します。
setAuthenticationByApiKey(apiKey)voidAPI キーを使用してリクエストを認証し、追加の割り当てを利用できるようにします。
setAuthenticationByApiKey(apiKey, signingKey)voidAPI キーと署名鍵を使用してリクエストを認証し、StaticMap で追加の割り当てを利用できるようにします。

詳細なドキュメント

decodePolyline(polyline)

エンコードされたポリライン文字列をデコードして、ポイントの配列に戻します。 

// Decodes a string representation of the latitudes and longitudes of
// Minneapolis and Milwaukee respectively.
const polyline = 'qvkpG`qhxPbgyI_zq_@';
const points = Maps.decodePolyline(polyline);
for (let i = 0; i < points.length; i += 2) {
  Logger.log('%s, %s', points[i], points[i + 1]);
}

パラメータ

名前タイプ説明
polylineStringデコードするエンコードされたポリライン。

戻る

Number[] - 緯度と経度のペアの配列（lat0、long0、lat1、long1、...）。

関連情報

encodePolyline(points)

ポイントの配列を文字列にエンコードします。 

// The latitudes and longitudes of New York and Boston respectively.
const points = [40.77, -73.97, 42.34, -71.04];
const polyline = Maps.encodePolyline(points);

パラメータ

名前タイプ説明
pointsNumber[]エンコードする緯度と経度のペアの配列。

戻る

String - これらのポイントを表すエンコードされた文字列。

関連情報

newDirectionFinder()

新しい DirectionFinder オブジェクトを作成します。

戻る

DirectionFinder - 新しい経路検索オブジェクト。

newElevationSampler()

ElevationSampler オブジェクトを作成します。

戻る

ElevationSampler - 新しい標高サンプラー オブジェクト。

newGeocoder()

新しい Geocoder オブジェクトを作成します。

戻る

Geocoder - 新しいジオコーダー オブジェクト。

newStaticMap()

新しい StaticMap オブジェクトを作成します。

戻る

StaticMap - 新しい静的地図オブジェクト。

resetAuthenticationApiKey()

認証情報をリセットして、デフォルトの割り当て制限を使用します。このメソッドは、API キーを使用してリクエストを認証する場合に機能します。認証情報を提供せずに Maps メソッドを使用する場合は、このメソッドを使用してデフォルトの割り当て制限に戻すことができます。 

Maps.resetAuthenticationApiKey();

例外

Error - 認証に setAuthentication(clientId, signingKey) が使用されている場合。

setAuthenticationByApiKey(apiKey)

API キーを使用してリクエストを認証し、追加の割り当てを利用できるようにします。

このメソッドは、リクエストの認証に使用する API キーを設定するために使用されます。この メソッドが呼び出されると、料金表に従って、提供された API キーに関連付けられた Google Cloud プロジェクト に割り当ての使用量と請求が発生します。認証情報を提供しなくても、デフォルトの割り当て制限で Maps メソッドを使用できます。StaticMap を使用している場合は、代わりに setAuthenticationByApiKey(apiKey, signingKey) メソッドを使用してください。 

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0');

パラメータ

名前タイプ説明
apiKeyStringクイックスタート ガイドの手順 に沿って Google Cloud コンソールから取得できる API キー。

例外

Error - apiKey が null の場合、または setAuthentication(clientId, signingKey) がすでに認証に使用されている場合

setAuthenticationByApiKey(apiKey, signingKey)

API キーと署名鍵を使用してリクエストを認証し、StaticMap で追加の割り当てを利用できるようにします。Static Map API へのリクエストには signingKey が必要ですが、このメソッドを使用して他の Maps サービスを認証することもできます。その場合、signingKey パラメータは無視されます。

このメソッドは、リクエストの認証に使用する API キーと署名鍵を設定するために使用されます。StaticMap には署名鍵が必要です。テスト目的で署名なしで少数のリクエストを受け付けますが、本番環境で上限に達すると失敗し始めます。詳細については、こちらをご覧ください。 

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0',
'7_pry-Skg0PKxds-7nvdl91mB5=');

パラメータ

名前タイプ説明
apiKeyStringクイックスタート ガイドの手順 に沿って Google Cloud コンソールから取得できる API キー。
signingKeyStringデジタル署名のガイド の手順に沿って Google Cloud コンソールから取得できる署名鍵。これは StaticMap に必要であり、他の Maps サービスでは無視されます。

例外

Error - apiKey が null の場合、または setAuthentication(clientId, signingKey) がすでに認証に使用されている場合

関連情報

サポート終了のメソッド