メイン コンテンツをスキップする 補完的コンテンツへスキップ

演算

AddressPointLookup

テーブル内の住所のポイント ジオメトリ、つまりジオコーディングを返します。[Search Text] プロパティで住所文字列を指定するか、[Country]、[Street] などの対応するプロパティで構造化パーツを指定します。組み合わせも可能です。この演算には特別なライセンスが必要です。何らかの理由で見つからなかった住所は、結果に返されません。

Qlik ジオコーディング (AddressPointLookup と PointToAddressLookup による) が提供する関数は、場所検索機能とは異なります。Qlik ジオコーディングでは、住所レベルで検索できます。一方、通常の場所検索では郵便番号レベルまでの精度しかありません。

Qlik ジオコーディングを使い始める際は、「Qlik ジオコーディングの構成 (英語のみ)」で参照されるテンプレートを使用します。

情報メモ 最善の結果を得るには、具体的なデータを優先し、広範なデータは可能な限り省略してください。例えば、郵便番号と郵便都市の両方があり、郵便番号が正しいと確信している場合は、郵便都市を指定しないことをお勧めします。

ほとんどのパラメータには 2 つのバージョンがあります。1 つは country="SWE" のように実際の値を指定し、もう 1 つは countryField="CountryIso2" のように実際の値を取得する項目名を指定します。

情報メモ 中国で英語または拼音の住所をジオコーディングするには、[Country] パラメータを「CHN」に設定する必要があります。

次の列を返します:

  • <dataset key column> - 入力 dataset のキー列
  • Address - 国の基準に対応するようにフォーマットされた、見つかった住所。
  • Geometry - 見つかったアイテムのポイント。
  • HouseNumber - 見つかったアイテムの家番号。
  • Street - 見つかったアイテムの通り。
  • PostalCode - 見つかったアイテムの郵便番号。
  • City - 見つかったアイテムの都市レベルの行政区画の名前。
  • Adm1 - 見つかったアイテムの 1 次行政区画 (州) の名前または略称。
  • CountryIso2 - 見つかったアイテムの国コード。
  • Match - 一致がどれだけ良かったかを示す 0 から 1 までの値。1 は完璧を意味します。
  • [dataset] のキー列を除くすべての列で、データセット名のプレフィックスが付いています。

適用できない場合、またはデータが利用できない場合、返される項目は空になる可能性があります。

対応バージョン:

  • ロード スクリプトの ScriptEval

各アイテムがそれぞれの項目にあるスウェーデンの住所をジオコーディングする例:

[Addresses]: Load * inline [ Id,Country,City,Street,HouseNumber,Postal 1,SE,Gothenburg,Odinsgatan,13,41103 2,SE,,Alfhemsgatan,5,41310 ]; Load * Extension GeoOperations.ScriptEval(' Select Id, Address, AddressPoint From AddressPointLookup(countryField="Country", cityField="City", streetField="Street", houseNumberField="HouseNumber", postalCodeField="Postal") ', Addresses);

この例は、フリー テキスト スタイルのジオコーディングを示しています:

[Addresses2]: Load * inline [ Id;Address 1;1600 Pennsylvania Avenue NW, Washington, D.C. 20500 2;767 5th Ave, New York, NY 10153 ] (delimiter is ';'); Load * Extension GeoOperations.ScriptEval(' AddressPointLookup(searchTextField="Address", country="USA") ', Addresses2);
AddressPointLookup のパラメーター
パラメーター タイプ 使用 説明
searchText string オプション 検索するテキストの文字列。「1600 Pennsylvania Ave, Washington DC, USA」のような住所、または「1117 Washington Ave」のように、City が「Philadelphia」に設定され、Country が「USA」に設定されている「1117 Washington Ave」などの他の項目のデータと組み合わされた不完全な住所にすることができます。
searchTextField string オプション [searchText] が指定されていない場合、このパラメータを使用して、情報を取得する項目を指定できます。
パラメータは string オプション 3 文字の ISO コードを持つ文字列。「SWE,NOR,FIN」のように、複数の国をカンマで区切って指定できます。特に中国で英語または拼音の住所をジオコーディングするには、このパラメーターを「CHN」に設定する必要があります。
countryField string オプション [country] が指定されていない場合、このパラメータを使用して、国名または 2 文字または 3 文字の ISO コードを含む項目を指定できます。他のパラメータとは対照的に、[country] および [countryField] で指定されたデータの予想される形式は同一ではないことに注意してください。country パラメータは 3 文字の ISO 形式のみ、複数の国を許可しますが、countryField は異なる国の形式を許可します。
string オプション 州名またはコード。ほとんどの国では、州は住所の一部ではありません。
stateField string オプション [state] が指定されていない場合、このパラメータを使用して、情報を取得する項目を指定できます。
string オプション 都市名、市町村または郵便都市。
cityField string オプション [city] が指定されていない場合、このパラメータを使用して、情報を取得する項目を指定できます。
string オプション 郵便番号。
postalCodeField string オプション [postalCode] が指定されていない場合、このパラメータを使用して、情報を取得する項目を指定できます。
string オプション 通りの名前。通りと家番号を別々のパラメータまたは項目で指定する代わりに、スペースで区切って両方を一緒に指定することができます。
streetField string オプション [street] が指定されていない場合、このパラメータを使用して、情報を取得する項目を指定できます。
string オプション 家番号。
houseNumberField string オプション [houseNumber] が指定されていない場合、このパラメータを使用して、情報を取得する項目を指定できます。
matchThreshold 実数 default:0.5 これよりも一致度の高い結果のみを返します。誤ったヒットが多すぎる場合は、この値を増やしてください。
言語 string default: ありません。 返信の住所の優先言語の 2 文字の言語コード。要求された言語でアドレスが利用できない場合は、その場所の既定言語で返されます。
データセット データセット default: ありません。 ジオコーダーで検索される住所を含むデータセット。ロード スクリプトから送信されたときにこのデータセットのストリーミングをサポートします。これは、より大きなテーブルが許可されることを意味します。
有効桁数 整数 既定: 6 座標で丸める小数点以下の桁数を設定します。既定値は小数点以下 6 桁で、精度は約 10cm です。座標を丸めたくない場合は、値を負の数に設定します。

ビニング

ポイント データセットの長方形または六角形のビンを生成します。これは、ポイント データを集約して、データの概要を効率的に表示できるようにする方法です。

次の列を返します:

  • <dataset key column> - 入力 dataset のキー列
  • BinId - ビンの ID。
  • BinTable.BinPolygon - ビンのポリゴン。
  • BinTable.CenterPoint - ビンの中心にあるポイント。
  • [dataset] のキー列を除くすべての列で、データセット名のプレフィックスが付いています。

対応バージョン:

  • ロード スクリプトの ScriptEval

米国の空港から六角形のビンをロードする例:

Load * Extension GeoOperations.ScriptEval(' Binning(type="hexagonal", gridSize="1") DATASOURCE airports LOCATIONSERVICE geometry="POINT", type="AirportIATA", country="us" ');
ビニングのパラメーター
パラメーター タイプ 使用 説明
タイプ string default:rectangular 長方形または六角形のビンを生成するかどうかを定義します。
gridSize 実数 default: ありません。 個々のビンの高さ (度)。1 度は約 10000 メートルです。
gridWidthHeightRatio 実数 default:1.5 ビンの幅と高さの比率。多くの場合、正方形のビンが最適ですが、緯度によって異なります。最適な幅と高さの比率の式は、1/cos(latitude) です。たとえば、赤道で 1、緯度 + -30度で 1.15、緯度 + -60 度で 2 です。メルカトル プロジェクションよりも適応型プロジェクションでビニングされたデータを表示する方がよく見えることがよくあります。
データセット データセット default: ありません。 ビンを生成するためのポイント ジオメトリを含むデータセット。ロード スクリプトから送信されたときにこのデータセットのストリーミングをサポートします。これは、より大きなテーブルが許可されることを意味します。
有効桁数 整数 既定: 6 座標で丸める小数点以下の桁数を設定します。既定値は小数点以下 6 桁で、精度は約 10cm です。座標を丸めたくない場合は、値を負の数に設定します。

[Within] ではなく

最大距離よりも近い場合は、あるデータセット内のオブジェクトと別のデータセット内の最も近い n 個のオブジェクト間の関係と距離を返します。コストは道路に沿って計算することもでき、その場合はオプションで移動時間を使用します。この演算は多くの場合、最も近いオブジェクトとの関係を取得するだけでなく、一連のポイント間の距離マトリックスを取得する場合にも役立ちます。

次の列を返します:

  • <dataset1 name>_<dataset2 name>_RelationId - 2 つのジオメトリ間の関係のために生成されたキー。
  • <dataset1 key column> - 入力 dataset1 のキー列。
  • <dataset2 key column> - 入力 dataset2 のキー列。
  • Distance - costUnit で指定された単位での距離。
  • Status - 返されるステータスは「ok」または「failed:」のいずれかで、その後にエラーメッセージが表示されます。
  • LowResLine - ルート ラインの低解像度バージョン。[bird] 以外の距離タイプでのみ使用できます。
  • 入力 [dataset1] データセットのキー列を除くすべての列で、データセット名のプレフィックスが付いています。
  • 入力 [dataset2] データセットのキー列を除くすべての列で、データセット名のプレフィックスが付いています。

対応バージョン:

  • ロード スクリプトの ScriptEval

この例では、テーブル内のポイントに最も近い空港を検索します:

MyPoints: LOAD * inline " id;point 1;[12,57.7] 2;[12.1,57.7] " (delimiter is ';'); MyClosestAirports: Load * Extension GeoOperations.ScriptEval(' Closest(distance="100000", closestCount="3") DATASOURCE pts INTABLE keyField="id", pointField="point" DATASOURCE airports LOCATIONSERVICE geometry="POINT", type="AirportIATA", country="se" ', MyPoints);
Closest のパラメーター
パラメーター タイプ 使用 説明
距離 実数 default: ありません。 Cost 単位で指定された単位での最大距離。これ以上にさらに離れているアイテムは無視されます。
costUnit string default:meters メートル、ヤード、キロメートル、マイル、秒、分、時間のいずれかである必要があります。時間単位を使用することは、移動時間が、距離が使用されるコストと長さの単位として使用されることを意味します。時間単位は、距離タイプ [Bird] には使用できません。
distanceType 実数 default:Bird 距離の測定方法を決定します。次の値が許可されます:
  • Bird - オブジェクト間の (カラスが飛ぶときの) 直接距離を測定します。
  • Car - 車の制限がある道路に沿って測定します。ポイント データセットでのみサポートされます。
  • Bike - 自転車の制限がある道路に沿って測定します。ポイント データセットでのみサポートされます。
  • Pedestrian - 歩行者の制限がある道路に沿って測定します。ポイント データセットでのみサポートされます。
  • Truck - トラックの制限がある道路に沿って測定します。ポイント データセットでのみサポートされます。
closestCount 実数 default:1 最初のデータセットのオブジェクトに関連付ける 2 番目のデータセットのオブジェクトの数。値 1 は最も近いものだけを意味し、2 は最も近い 2 つを意味します。
dataset1 データ セット default:<first dataset> 指定されている場合は dataset2 内のオブジェクトへの近さをチェックするオブジェクト、そうでない場合はオブジェクト自体への近さ。1 つのデータセット内のオブジェクト間の近さをチェックする場合、関係がオブジェクトからそれ自体に追加されることはありません。ロード スクリプトから送信されたとき、および [dataset2] が定義されたときに、このデータセットのストリーミングをサポートします。これは、より大きなテーブルが許可されることを意味します。
dataset2 データ セット default:<second dataset if any> dataset1 に関連するオブジェクト。
有効桁数 整数 既定: 6 座標で丸める小数点以下の桁数を設定します。既定値は小数点以下 6 桁で、精度は約 10cm です。座標を丸めたくない場合は、値を負の数に設定します。

クラスター

ポイント間の地理的な近さに基づいて、ポイント データセットからクラスターを生成します。クラスターの生成は、距離パラメータによって制御されます。距離パラメーターは、ポイントが属するクラスターからポイントがどれだけ離れているかを定義します。ポイントとクラスター間の関係を含むテーブルを返します。また、クラスター ジオメトリを持つ [Clusters] という名前の結合テーブルを返します。これには、項目 [ClusterID]、[ClusterCenter] (ポイント ジオメトリ)、[PointCount] が含まれています。[count] 項目には、クラスター内のポイントの数が含まれます。

次の列を返します:

  • <dataset key column> - 入力 dataset のキー列
  • ClusterID - ポイントが属するクラスターの ID。
  • Clusters.ClusterPoint - クラスターの中心点。
  • Clusters.PointCount - クラスターに属する元のポイントの数 。
  • 入力データセットのキー列を除くすべての列で、データセット名のプレフィックスが付いています。

対応バージョン:

  • ロード スクリプトの ScriptEval

この例では、米国の空港をクラスター化して、50 km より近い空港が 1 つのクラスターに属するようにします:

MyClusteredAirports: Load * Extension GeoOperations.ScriptEval(' Cluster(distance="50000") DATASOURCE airports LOCATIONSERVICE geometry="POINT", type="AirportIATA", country="us" ');
クラスターのパラメーター
パラメーター タイプ 使用 説明
距離 実数 default: ありません。 ポイントとそのクラスターの間の距離は、メートル単位のこの距離より長くはありません。
データセット データセット default: ありません。 クラスター化するポイントを含むデータセット。
有効桁数 整数 既定: 6 座標で丸める小数点以下の桁数を設定します。既定値は小数点以下 6 桁で、精度は約 10cm です。座標を丸めたくない場合は、値を負の数に設定します。

融合

古いエリア ID (またはジオメトリ) および新しいエリア ID の間のマッピングに基づいて、エリアを融合および簡略化して、より大きなエリアを形成します。これは通常、郵便エリアや行政区画など、明確に定義された小さなエリアによって構築されるカスタム エリアを構築するために使用されます。

次の列を返します:

  • <dissolveField> - indata で dissolveField として指定された項目。
  • DissolvedPolygon - 新しい融合エリアのジオメトリ。

対応バージョン:

  • ロード スクリプトの ScriptEval

ジオメトリ データセットはオプションです。指定されていない場合、ジオメトリは融合定義データセットで利用可能であると想定されます。

ポリゴンのオーバーラップは、[Source] を除くすべての解像度で削除されることに注意してください。

この例では、2 つの地域を作成します。1 つは CA と AZ で構成され、もう 1 つは WA と OR で構成されます:

MySalesRegions: LOAD * inline " Adm1Code;RegionName California;SouthWest Arizona;SouthWest Washington;NorthWest Oregon;NorthWest " (delimiter is ';'); MySalesRegionGeometries: Load * Extension GeoOperations.ScriptEval(' Dissolve(dissolveField="RegionName", areaDatasetKeyField="Name") DATASOURCE states LOCATIONSERVICE type="State", country="us" ', MySalesRegions);
融合のパラメーター
パラメーター タイプ 使用 説明
dissolveField string default:<[dissolveDataset] のキー項目と同じ> dissolveDataset の新しいエリアの ID を持つ項目の名前。
解像度 string default:Auto 結果のデータセットは簡素化され、簡素化の程度はこのプロパティによって制御されます。利用可能な値は次のとおりです:
  • auto - この演算では、データに基づいて解像度が計算されます。
  • autolow - 自動解像度 (の半分) よりも低い解像度。
  • autohigh - 自動解像度 (の2倍) よりも高い解像度。
  • source - 簡素化は実行されません。[dissolveDataset] に同じ古いエリアが 2 つの異なる新しいエリアに 2 回含まれている場合は、[source] を使用する必要があることに注意してください。
[areaDatasetKeyField] string default:<areaDataset 内のキー項目> [areaDataset] 内の元のエリアの ID。これは、[areaDataset] が指定されている場合にのみ使用されます。
[dissolveDataset] データ セット default:<first dataset> 各古いエリアが属する新しいエリアの定義、つまり古いエリアと新しいエリア ID 間のマッピング。キー項目は指定されている場合、[areaDataset] のキーにマップする必要があります。[areaDataset] が提供されていない場合、ジオメトリはこのデータセットで利用可能である必要があります。
areaDataset データ セット default:<second dataset if any> 融合するエリア ジオメトリを含むデータセット。なしの場合もあります。これは、[dissolveDataset] でジオメトリを利用できるようにする必要があることを意味します。このデータセットの [areaDatasetKeyField] は、[dissolveDataset] のキー項目にリンクする必要があります。
有効桁数 整数 既定: 6 座標で丸める小数点以下の桁数を設定します。既定値は小数点以下 6 桁で、精度は約 10cm です。座標を丸めたくない場合は、値を負の数に設定します。

交差

交差するすべてのオブジェクトについて、dataset1 のキーと dataset2 のキーの間でマップするテーブルを返します。両方のデータセットにポリゴンが含まれている場合、それぞれのデータセットのエリアと比較した相対的なオーバーラップ エリアが返されます。

[intersectsCount] を指定することにより、最初のデータセットの各ジオメトリにマップする必要がある 2 番目のデータセットの交差するジオメトリの数を制限することができます。次に、最も交差するジオメトリが順番に返されます。[intersectsCount] が指定されていない場合、演算は対称になります。

次の列を返します:

  • <dataset1 name>_<dataset2 name>_RelationId - 2 つのジオメトリ間の関係のために生成されたキー。
  • <dataset1 key column> - 入力 dataset1 のキー列。
  • <dataset2 key column> - 入力 dataset2 のキー列。
  • <dataset1 name>.RelativeOverlap - dataset1 のポリゴンと比較したオーバーラップ。両方のデータセットにポリゴンが含まれている場合にのみ返されます。この項目を要求すると、パフォーマンスが低下します。
  • <dataset2 name>.RelativeOverlap - dataset2 のポリゴンと比較したオーバーラップ。両方のデータセットにポリゴンが含まれている場合にのみ返されます。この項目を要求すると、パフォーマンスが低下します。
  • 入力 [dataset1] データセットのキー列を除くすべての列で、データセット名のプレフィックスが付いています。
  • 入力 [dataset2] データセットのキー列を除くすべての列で、データセット名のプレフィックスが付いています。

対応バージョン:

  • ロード スクリプトの ScriptEval

この例では、いくつかの線が交差する州を計算します:

MyLines: LOAD * inline " id;line 1;[[-108.1,45.4],[-107.4,44.9]] 2;[[-98.9,40.1],[-100.4,40.9]] " (delimiter is ';'); LinesInStates: Load * Extension GeoOperations.ScriptEval(' SELECT id, states.Name FROM Intersects() DATASOURCE states LOCATIONSERVICE geometry="AREA", type="Admin1", country="us" ', MyLines);
交差のパラメーター
パラメーター タイプ 使用 説明
dataset1 データ セット default:<first dataset> 指定されている場合は、他のデータセットのジオメトリと交差するかどうか、指定されていない場合は、このデータセットのオブジェクト間のジオメトリと交差するかどうかをテストするジオメトリを持つデータセット。1 つのデータセット内のオブジェクト間の交差をチェックする場合、関係はオブジェクトからそれ自体に追加されることはありません。ロード スクリプトから送信されたとき、および [dataset2] が定義されたときに、このデータセットのストリーミングをサポートします。これは、より大きなテーブルが許可されることを意味します。
dataset2 データ セット default:<second dataset if any> 他のデータセットのジオメトリと交差するかどうかをテストするジオメトリを持つデータセット。指定しない場合、[dataset1] 内のオブジェクト間の交差が計算されます。
intersectsCount integer default:0 0 より大きい場合、dataset2 の交差するジオメトリの最大数が dataset1 ジオメトリごとに返されます。最も交差するもの (最大のオーバーラップするエリアまたは長さ) のみが返されます。
有効桁数 整数 既定: 6 座標で丸める小数点以下の桁数を設定します。既定値は小数点以下 6 桁で、精度は約 10cm です。座標を丸めたくない場合は、値を負の数に設定します。

IpLookup

テーブル内の IP アドレスの位置情報とポイント ジオメトリを返します。これは、ウェブ サービスへのアクセス データを分析するときに役立ちます。返されるテーブルには、次の項目が含まれています:
  • キー項目 - 名前テーブルのキー項目と同じ。
  • <アドレス テーブル Ip 項目> - 検索された IP 項目と同じ。キー項目と同じでない場合にのみ使用できます。
  • IpPoint - 見つかったアイテムのポイント。
  • CountryIso2 - 見つかったアイテムの国コード。
  • Adm1Code - 見つかったアイテムの 1 次行政区画のコード。このコードは、ロケーション サービスによって返されるコードと常に互換性があるとは限らないことに注意してください。
  • City - 見つかったアイテムの都市。
  • 入力データセットのキー列を除くすべての列で、データセット名のプレフィックスが付いています。

IP ジオロケーションは本質的に不正確です。多くの IP アドレスでは都市を特定することができますが、他の IP アドレスでは国のみを解決できます。

ベスト プラクティスは、Ip 列を [IpLookup] 演算にのみ送信することです。いくつかの IP アドレスを検索する例:

MyIpData: LOAD * inline " User;Ip Alice;188.12.2.2 Bob;176.77.23.14 " (delimiter is ';'); MyIpPoints: Load * Extension GeoOperations.ScriptEval(' IpLookup(ipField="Ip") ', MyIpData{Ip});

同じ IP が多くの行で繰り返されるのが一般的です。次に、パフォーマンスが向上し、最初にこの例のように一意の IP のみが除外されます:

MyIpData: LOAD * inline " User;Ip Alice;176.77.23.14 Bob;188.12.2.2 Carol;176.77.23.14 Dave;188.12.2.2 Bob;188.12.2.2 Bob;188.12.2.2 " (delimiter is ';'); MyDistinctIpData: Load distinct Ip resident MyIpData; MyIpPoints: Load * Extension GeoOperations.ScriptEval(' IpLookup(ipField="Ip") ', MyDistinctIpData); Drop Table MyDistinctIpData;

この製品には、MaxMind によって作成された GeoLite2 データが含まれており、MaxMind から入手できます。

IpLookup のパラメーター
パラメーター タイプ 使用 説明
ipField string オプション 検索する IP アドレスを含む項目。指定されていない場合は、データセットのキー項目を使用します。
データセット データセット default: ありません。 ジオコーダーで検索される IP アドレスを含むデータセット。ロード スクリプトから送信されたときにこのデータセットのストリーミングをサポートします。これは、より大きなテーブルが許可されることを意味します。
有効桁数 整数 既定: 6 座標で丸める小数点以下の桁数を設定します。既定値は小数点以下 6 桁で、精度は約 10cm です。座標を丸めたくない場合は、値を負の数に設定します。

ロード

演算は適用せずにデータセットをロードします。これにより、GeoOperations がサポートするすべての形式をロードできます。ジオメトリが詳細で表示が遅い場合は、[Simplify] が [Load] の良い代替案になる場合があることに注意してください。

次の列を返します:

  • [dataset] のすべての列。

対応バージョン:

  • ロード スクリプトの ScriptEval

スウェーデンから郵便番号をロードする例:

Load * Extension GeoOperations.ScriptEval('Load() DATASOURCE PostalCodes LOCATIONSERVICE type="PostalCode", country="se"');

WKT は INTABLE のデータのジオメトリ形式としてサポートされているため、[Load] 操作は、データベースからロードされた地理ジオメトリを Sense ジオメトリ形式に変換して表示できるようにするのに最適です。次の例は、WKT データを変換する方法を示しています。この場合は [MyWKTData] テーブルからです:

MyWKTData: LOAD *inline " id;wkt 1;POINT(-80.204 25.791) 2;POINT(-81.381 28.538)" (delimiter is ';'); Load * Extension GeoOperations.ScriptEval(' Select id, wkt as point From Load() ', MyWKTData);
ロードのパラメーター
パラメーター タイプ 使用 説明
データセット データ セット default:<first dataset> ロードするデータセット。ロード スクリプトから送信されたときにこのデータセットのストリーミングをサポートします。これは、より大きなテーブルが許可されることを意味します。
有効桁数 整数 既定: 6 座標で丸める小数点以下の桁数を設定します。既定値は小数点以下 6 桁で、精度は約 10cm です。座標を丸めたくない場合は、値を負の数に設定します。

PointToAddressLookup

リスト内のポイントに最も近い住所を返します。これは、逆ジオコーディングとも呼ばれます。この演算には特別なライセンスが必要です。通りに近いポイントは通りレベルの住所を取得します。そうでない場合は、フォール バックして郵便エリアまたは都市レベルのヒットを返します。遠すぎるポイントの場合、データは返されません。

次の列を返します:

  • <dataset key column> - 入力 dataset のキー列
  • Address - 国の基準に対応するようにフォーマットされた、見つかった住所。
  • Geometry - 見つかったアイテムのポイント。
  • HouseNumber - 見つかったアイテムの家番号。
  • Street - 見つかったアイテムの通り。
  • PostalCode - 見つかったアイテムの郵便番号。
  • City - 見つかったアイテムの都市レベルの行政区画の名前。
  • Adm1 - 見つかったアイテムの 1 次行政区画 (州) の名前または略称。
  • CountryIso2 - 見つかったアイテムの国コード。
  • Distance - 見つかった住所までのメートル単位の距離。
  • [dataset] のキー列を除くすべての列で、データセット名のプレフィックスが付いています。

適用できない場合、またはデータが利用できない場合、返される項目は空になる可能性があることに注意してください。

いくつかのポイントの住所を取得する例:

MyAddressPoints: LOAD * inline " id;point 1;[-108.1,45.4] 2;[-98.9,40.1] 3;[12.1,57.7] " (delimiter is ';'); Load * Extension GeoOperations.ScriptEval(' PointToAddressLookup() ', MyAddressPoints);
AddressPointLookup のパラメーター
パラメーター タイプ 使用 説明
言語 string default: 返信の住所の優先言語の 2 文字の言語コード。要求された言語でアドレスが利用できない場合は、その場所の既定言語で返されます。
データセット データセット default: ありません。 ジオコーダーで検索されるポイントを含むデータセット。ロード スクリプトから送信されたときにこのデータセットのストリーミングをサポートします。これは、より大きなテーブルが許可されることを意味します。
有効桁数 整数 既定: 6 座標で丸める小数点以下の桁数を設定します。既定値は小数点以下 6 桁で、精度は約 10cm です。座標を丸めたくない場合は、値を負の数に設定します。

ルート

テーブル内の 2 つの場所の間のルートを、長さと期間を含めて計算します。

原点はデータセットのジオメトリ列であることに注意してください。データセットは 1 つのジオメトリ列しか認識しないため、宛先列は演算パラメータで指定されます。

輸送タイプとして [bird] を使用すると、原点と終点の間に大きな円弧が生成されます。

次の列を返します:

  • <dataset key column> - 入力 dataset のキー列
  • Distance - メートル単位のルート距離。
  • Duration - 推定ルート移動時間 (秒単位)。
  • Status - 返されるステータスは「ok」または「failed:」のいずれかで、その後にエラーメッセージが表示されます。
  • LowResLine - ルート ラインの低解像度バージョン。
  • 入力データセットのキー列を除くすべての列で、データセット名のプレフィックスが付いています。

対応バージョン:

  • ロード スクリプトの ScriptEval
  • ルートを取得するためのチャート スクリプトの ScriptEvalStr。
  • 距離または期間を取得するためのチャート スクリプトの ScriptEval。

これは、データセット内のポイント間のルートを計算する例です:

MyRoutePoints: LOAD * inline " routeid;origin;dest 1;[12,57.7];[12,57.8] 2;[12.1,57.7];[12.2,57.7] " (delimiter is ';'); MyRoutes: Load * Extension GeoOperations.ScriptEval('Routes(destField="dest")', MyRoutePoints);

これは、Line Layer で直接ルートを計算する例です。選択が変更されるたびに、選択に対して演算が呼び出されます。通常、少数のポイントのみが選択されている場合に真となる計算条件が存在するはずです (それ以外の場合は、ロードスクリプトでルートを計算することをお勧めします)。これをロード スクリプトに入れて、データをロードする必要があります。例:

Load * Extension GeoOperations.ScriptEval( 'Load() DATASOURCE Cities LOCATIONSERVICE geometry="POINT", type="City", country="dk"');

ライン レイヤーで次の軸を使用します:

LocationDbId

ライン レイヤーで計算条件を使用します:

Count(LocationDbId)<10

Line ジオメトリに設定する必要がある Location プロパティに、これを配置して、固定位置から選択したポイントまでのルートを計算します。

=GeoOperations.ScriptEvalStr('SELECT LowResLine from Routes(originField="Me", destField="LocationPoint")', '[11.2,54.8]' as Me, LocationPoint)

ルートのパラメーター
パラメーター タイプ 使用 説明
データセット データセット default: ありません。 計算するルートの原点と終点を含むデータセット。原点はデータセットのジオメトリにある必要があります。ロード スクリプトから送信されたときにこのデータセットのストリーミングをサポートします。これは、より大きなテーブルが許可されることを意味します。
基準 string default:fastest 計算する [最速] ルートまたは [最短] ルートから選択します。
転送 string default:car [car]、[truck]、[bike]、[pedestrian]、[bird] (10 m/秒で飛行) のいずれかの輸送モード。
のジオメトリのタイプ string default: ありません。 終点を指定するデータセット内の項目。原点は、データセットで指定されたジオメトリ項目であることに注意してください。
geometryType string default:POINT [destField] のジオメトリのタイプ。許可される値は、[Point]、[NamedPoint]、[LatLon] です。名前付きポイントの場合、ジオメトリはロケーション サービスで検索され、ジオメトリの列が追加されます。
サフィックス string default: ありません。 上級ユーザー向け。指定された文字列がすべての ID に追加されます。これは、国コードやタイプなど、サーバー ベースのロケーション サービスに詳細情報を指定するための便利な方法です。別の方法は、テーブルを Qlik にロードするときに追加のデータを追加することです。次のサフィックス、[,SE:city] を使用すると、すべてのアイテムがスウェーデンの都市として指定されます。
,SE:city
使用する構文の詳細については、「Location Service Guide」を参照してください。
有効桁数 整数 既定: 6 座標で丸める小数点以下の桁数を設定します。既定値は小数点以下 6 桁で、精度は約 10cm です。座標を丸めたくない場合は、値を負の数に設定します。

[Load] 演算の代わりに

データセット内のラインとエリアのジオメトリを簡素化します。表示が高速でより効率的なジオメトリを取得するために、[Load] 演算の代わりに [Simplify] 演算を使用して地理データをロードすると便利です。

簡素化の程度は、エリア、オブジェクトの数、オブジェクトのサイズに基づいて自動的に計算されます。次に、[resolution] パラメータを使用してそれをより高いまたはより低い解像度に調整することができます。

エリアの簡素化は、トポロジを処理し、ギャップを削除してアイランドを結合できるアルゴリズムを使用して行われます。

行の簡素化は、ブレイクポイント削減アルゴリズムを使用して行われます。

ポリゴンのオーバーラップが削除されることに注意してください。出力にオーバーラップするポリゴンはありません。

次の列を返します:

  • <dataset key column> - 入力 dataset1 のキー列。
  • Simplified_<geometry column name> - 元のジオメトリの簡素化されたバージョン。
  • [dataset] のキー列を除くすべての列で、データセット名のプレフィックスが付いています。

対応バージョン:

  • ロード スクリプトの ScriptEval

米国の州の簡素化バージョンをロードする例:

Load * Extension GeoOperations.ScriptEval(' SELECT LocationDbId, Simplified_LocationPolygon FROM Simplify() DATASOURCE states LOCATIONSERVICE type="State", country="us" ');
簡素化のパラメーター
パラメーター タイプ 使用 説明
解像度 string default:Auto 結果のデータセットは簡素化され、簡素化の程度はこのプロパティによって制御されます。利用可能な値は次のとおりです:
  • Auto - この演算では、データに基づいて解像度が計算されます。
  • AutoLow - 自動解像度 (の半分) よりも低い解像度。
  • AutoHigh - 自動解像度 (の2倍) よりも高い解像度。
データセット データ セット default:<first dataset> 簡素化するためのジオメトリを含むデータセット。
有効桁数 整数 既定: 6 座標で丸める小数点以下の桁数を設定します。既定値は小数点以下 6 桁で、精度は約 10cm です。座標を丸めたくない場合は、値を負の数に設定します。

TravelAreas

移動時間の iso エリアを計算します。返却されたエリア内のすべての場所は、特定の時間内に到達できるか、道路に沿った特定の距離よりも近くにあります。ID、移動エリアのジオメトリ、中心点、コスト、コスト単位、ステータス (OK または失敗) を含むテーブルを返します。

輸送タイプとして「bird」を使用すると、原点の周りに地理的に正しい円が生成されます。

次の列を返します:

  • <dataset key column> - 入力 dataset のキー列
  • TravelArea - 移動エリアを定義するポリゴン ジオメトリ。
  • Cost - costValue または costField で指定されたコスト。
  • CostUnit - costUnit で指定されたコスト単位。
  • Status - 返されるステータスは「OK」または「failed:」のいずれかで、その後にエラーメッセージが表示されます。
  • 入力データセットのキー列を除くすべての列で、データセット名のプレフィックスが付いています。

対応バージョン:

  • ロード スクリプトの ScriptEval
  • 移動エリアのジオメトリを取得するためのチャート スクリプトの ScriptEvalStr。
  • コストを取得するためのチャート スクリプトの ScriptEval。

このロード スクリプトの例では、座標からマイアミとオーランドに 10 分の移動エリアを生成します:

MyPoints: LOAD * inline " id;point 1;[-80.204,25.791] 2;[-81.381,28.538] " (delimiter is ';'); MyTravelAreas: Load * Extension GeoOperations.ScriptEval( 'SELECT id, TravelArea from TravelAreas(costValue="10", costUnit="Minutes")', MyPoints);

このロード スクリプトの例では、名前付きポイントを使用して、マイアミとオーランドに 10 分の移動エリアを生成します:

MyCities: LOAD * inline " cid;City 1;Miami,US 2;Orlando,FL,US " (delimiter is ';'); Load * Extension GeoOperations.ScriptEval('TravelAreas(costValue="10",costUnit="minutes") DATASOURCE cities INTABLE keyField="City", namedPointField="City"', MyCities {City});

これは、エリア レイヤー内のポイント周辺の Travel Area を直接計算する例です。選択が変更されるたびに、選択に対して演算が呼び出されます。これをロード スクリプトに入れて、例のデータをロードする必要があります。

MyAirports: Load * Extension GeoOperations.ScriptEval(' Load() DATASOURCE airports LOCATIONSERVICE geometry="POINT", type="AirportIATA", country="se" ');

以下のエリア レイヤー内の軸を使用します:

LocationDbId

エリア レイヤー内の演算実行条件を使用します:

Count(LocationDbId)<10

Location プロパティにこのように入力します:

=GeoOperations.ScriptEvalStr('Select TravelArea from TravelAreas(costValue="10", costUnit="minutes")', LocationPoint)

TravelAreas のパラメーター
パラメーター タイプ 使用 説明
データセット データ セット default:<first dataset> 移動エリアの計算の起点とオプションのコストを含むデータセット。ロード スクリプトから送信されたときにこのデータセットのストリーミングをサポートします。これは、より大きなテーブルが許可されることを意味します。
costValue 数値 default: ありません。 返却されたエリアの境界でのコスト。コストは、長さまたは時間のいずれかです。(以下のコスト単位を参照してください。)
costField string default: ありません。 コストを指定するデータセット内の項目。これは、costValue が空の場合にのみ使用されます。
costUnit string default:seconds 秒、分、時間、メートル、ヤード、キロメートル、マイルのいずれかである必要があります。時間単位を使用すると、その時間内に到達したエリアが計算され、長さ単位を使用すると、指定されたよりも移動距離が短いエリアが計算されます。
転送 string default:car [car]、[truck]、[bike]、[pedestrian]、[bird] (10 m/秒で飛行) のいずれかの輸送モード。
有効桁数 整数 既定: 6 座標で丸める小数点以下の桁数を設定します。既定値は小数点以下 6 桁で、精度は約 10cm です。座標を丸めたくない場合は、値を負の数に設定します。

Within

一方のデータセット (囲まれている) のジオメトリがもう一方のデータセット (囲んでいる) のエリア内に完全にある 2 つのデータセット間の関係を返します。見つかったすべての関係について、囲まれているキーと囲んでいるキーの間でマップされるテーブルを返します。

通常、データがどの領域にあるかを見つけるために使用します。 例えば、GPS の位置をテストするには、どの行政区画にいるのかを確認します。これは一種の逆ジオコーディングです。

次の列を返します:

  • <enclosed name>_<enclosing name>_RelationId - 2 つのジオメトリ間の関係のために生成されたキー。
  • <enclosed key column> - 入力 dataset1 のキー列。
  • <enclosing key column> - 入力 dataset2 のキー列。
  • 囲まれているデータセットのキー列を除くすべての列で、データセット名のプレフィックスが付いています。
  • 囲んでいるデータセットのキー列を除くすべての列で、データセット名のプレフィックスが付いています。

対応バージョン:

  • ロード スクリプトの ScriptEval

データの不正確さを補うために、Within ではなく Closest を使用する方が良い場合があります。例えば、行政区画に関連付けたい沿岸地域のポイント データがある場合、わずかな不正確さにより、ポイントがその地域からわずかに外れる可能性があります。

これは、どのポイントがどの州にあるかを計算するロード スクリプトの例です。

MyPoints: LOAD * inline " id;point 1;[-108.1,45.4] 2;[-98.9,40.1] 3;[12.1,57.7] " (delimiter is ';'); PointsInStates: Load * Extension GeoOperations.ScriptEval(' Within() DATASOURCE states LOCATIONSERVICE geometry="AREA", type="Admin1", country="us" ', MyPoints);
Within のパラメーター
パラメーター タイプ 使用 説明
囲まれた データ セット default:<first dataset> 囲まれているエリアをテストするためのジオメトリを含むデータセット。ロード スクリプトから送信されたときにこのデータセットのストリーミングをサポートします。これは、より大きなテーブルが許可されることを意味します。
囲まれた データ セット default:<second dataset> どのジオメトリを囲むかをテストするためのエリア ジオメトリを含むデータセット。ロード スクリプトから送信されたときにこのデータセットのストリーミングをサポートします。これは、より大きなテーブルが許可されることを意味します。
有効桁数 整数 既定: 6 座標で丸める小数点以下の桁数を設定します。既定値は小数点以下 6 桁で、精度は約 10cm です。座標を丸めたくない場合は、値を負の数に設定します。
 

このページは役に立ちましたか?

このページまたはコンテンツに、タイポ、ステップの省略、技術的エラーなどの問題が見つかった場合は、お知らせください。改善に役立たせていただきます。