ブロックリファレンス

BLOCKS Reference

Google Maps

住所を経緯度へ変換【アルファ版】

このブロックはアルファ版です。利用にあたっては利用申請が必要です。提供している機能は完全でない場合があり、下位互換性のない変更を加える可能性もあります。このため、テスト環境での使用に適しています。利用申請/機能改善の要望/不具合の報告などは、MAGELLAN BLOCKS のお問い合わせ機能からお願いします。

概要

このブロックは、Google Maps Platform の Geocoding API を使って、住所から経緯度を取得します。

住所を経緯度へ変換ブロックの概念図

(画像をクリックすると拡大表示されます。)

セルフサービスプランの場合は、利用する GCP プロジェクトにおいて、Geocoding API を有効化する必要があります。

このブロックは、Google Maps Platform の Geocoding API を利用しているため、その利用量に応じた料金が別途発生します(従量課金制)。料金について詳しくは、Google Maps Platform 料金表 のプレイス - Geocoding API の項を参照願います。

MAGELLAN BLOCKS では、利用する機能に合わせて、さまざまな API を利用しています。これらについても利用量に応じた料金が発生します。

  • データ保存先(Google Cloud Storage や BigQuery など)の操作:Google Cloud Platform の API
  • 機械学習の各機能:AI Platform の API

プロパティ

プロパティ名 説明
ブロック名

編集パネルに配置した当該ブロックの表示名が変更できます。

ブロックリストパネル中のブロック名は変更されません。

GCP API キー

このブロックで利用する Google Maps Platform API に必要な GCP の API キーを指定します。

GCP API キーは、次の手順で作成します。

  1. Google Cloud Platform コンソール へ移動します。
  2. プロジェクトを選択します。
  3. 画面上部にある[認証情報を作成]ボタンをクリックします。
  4. API キーを選択します。
住所が格納された変数

経緯度に変換したい住所が格納された変数を指定します。

変数値は、オブジェクトもしくはオブジェクトの配列で準備します。オブジェクトの形式は、以下の通りです。

{
  "address": 経緯度,
  "任意のキー": 任意の値
}
キー
address 文字列

住所を文字列で指定します(例:"福岡県福岡市中央区今泉1丁目19番22号")。「東京スカイツリー」や「東京タワー」などのランドマークでの指定も可能です。

任意のキー 任意の型

location・address・place_id 以外の任意のキーが指定できます(例:origin_address)。

この任意のキーと値のペアは、経緯度を取得した結果にも出力されます。

address キーで指定した住所は、経緯度を取得した結果では異なる住所表記で出力されることがあります。複数の住所から経緯度を取得する場合は、以下のように利用すると指定した住所と取得後の住所が特定しやすくなります。

[
  {
    "address": "東京スカイツリー",
    "origin_address": "東京スカイツリー"
  },
  {
    "address": "福岡県福岡市中央区今泉1丁目19番22号",
    "origin_address": "福岡県福岡市中央区今泉1丁目19番22号"
  }
]

この任意のキーを使用した際の経緯度を取得した結果については、「結果を格納する変数」プロパティの取得例を参照してください。

以下は、オブジェクトをオブジェクト生成ブロックで指定した例です。

オブジェクトをオブジェクト生成ブロックで指定する例

(画像をクリックすると拡大表示されます。)

このケースの場合は、このプロパティに _ を指定します。

オブジェクトの配列の場合は、以下のように指定します。

オブジェクトの配列をオブジェクト生成ブロックで指定する例

(画像をクリックすると拡大表示されます。)

このケースの場合は、このプロパティに _.locations を指定します。

結果を格納する変数

住所を経緯度へ変換した結果が格納される変数を指定します。

この変数には、以下に示すキーを含んだオブジェクトの配列が格納されます。

キー 説明
location

住所が格納された変数」プロパティで指定した address の住所から算出した経緯度です。

address

location の経緯度に対する住所です。「住所が格納された変数」プロパティで指定した address の住所とは異なる可能性があります。

place_id

address の Place ID です。

住所が格納された変数」プロパティで任意のキーを指定した場合は、そのキーと値のペアも格納されます。

以下は、格納されたオブジェクトの配列の例です。

[
  {
    "address": "日本、〒131-0045 東京都墨田区押上1丁目1−2",
    "origin_address": "東京スカイツリー",
    "location": "35.7100627,139.8107004",
    "place_id": "ChIJ35ov0dCOGGARKvdDH7NPHX0"
  },
  {
    "address": "日本、〒810-0021 福岡県福岡市中央区今泉1丁目19−22",
    "origin_address": "福岡県福岡市中央区今泉1丁目19番22号",
    "location": "33.5862291,130.3977837",
    "place_id": "ChIJnQgIVISRQTURdPXRme2PuI4"
  }
]

"origin_address"」は、「住所が格納された変数」プロパティで指定された任意のキーです。

ブロックメモ このブロックに関するメモが記載できます。このブロックの処理に影響しません。
住所の表記言語

変換された経緯度に対する住所の表記言語を選択します。

サポートしている言語のリストは、Google Maps Platform FAQ を参照してください。

経緯度の Google マップ URL をログへ出力

変換された経緯度の Google マップ URL をログに出力するかどうかを指定します。

  • チェックボックスをオン:出力する(初期値)
  • チェックボックスをオフ:出力しない

この情報は役に立ちましたか?