JViews Maps Faces Google™
View
コンポーネントで簡単なページを作成して、ページ内に Google™
マップを表示することができます。
簡単な Google マップ・ビューの作成
<jvmf:googleView style="width:500 px; height:300 px;" level="6" lon="-100" lat="40" key="myGoogleMapKey"/>
これは、500 x 300 ピクセルで、中心が北緯 40°西経 100°、ズーム・レベルが 7 のビューを作成します。
名前空間の宣言
ページで名前空間 jvmf (JViews Maps Faces 用) を宣言する必要があります。
<%@ taglib uri="http://www.ilog.com/jviews/tlds/jviews-maps-faces.tld prefix="jvmf" %>
Google View コンポーネントは、(クライアント側で) Google Maps
API を使用します。コンポーネントを (ローカル・ホストとは離れた) サーバーに表示するには、
コンポーネントで提供される Google キーに有効なアプリケーション・キーが含まれている必要があります。
このキーを取得するには、
JViews Google Maps コンポーネントを使用する前に、
「Google Maps API に登録する」
(http://code.google.com/apis/maps/signup.html) にアクセスして、
ユーザー・キーを登録する必要があります。
コンポーネントのサイズを指定する代わりの方法として、
width 属性と height 属性を使用する方法がありますが、style を使用する方法をお勧めします。
Width 属性と Height 属性の使用
<jvmf:googleView width="500" height="300" level="6" lon="-100" lat="40" key="myGoogleMapKey"/>
メモ
環境によっては (例えば、PPR (Partial Page Refresh) を使用する環境など)、
キーをコンポーネント・タグ内で指定せずに、別のステートメントでキーを登録する必要があります。
Trinidad での Google マップの事前宣言
例えば、Trinidad では以下のようになります。
<trh:script source="http://maps.google.com/maps?file=api&v=2&2=mykey" /> ... <tr:showDetailItem text="Background map"> <jvmf:googleView id="mapID" level="7" style="width:500px;height:300px" data="/data/world.ivl" /> </tr:showDetailItem>
概要、ズーム・ツール、パン・ツール、インターラクターなどの共通コンポーネントは、
このビューと互換性はありませんが、Google マップ・コントロールを使用することにより提供されます。
controls
属性を使用して、表示するコントロールを選択できます (http://code.google.com/apis/maps/documentation/controls.html を参照)。この JSF コンポーネントの主な用途は、JViews 地図レイヤー、記号、およびリンクを Google マップ・バックグラウンドで
重ね合わせることです。これは、
data
属性により行うことができます。
この場合、lat
属性と lon
属性は不要になります。Google マップ・コンポーネントは、デフォルトで、
JViews データが中心となります。nodeMovable
属性を使用して、
ユーザーがオーバーレイされた記号を移動できることを示すこともできます。
このフラグが設定されている場合、ユーザーの各インタラクションがサーバー側の記号の位置に
影響するため、記号の位置を効率的に変更することができます。JViews 地図レイヤーと
Google マップ・コントロールの使用
<jvmf:googleView id="gmapID" key="some Google Maps Key" style="width:500px;height:500px" data="/data/usa.idpr" controls="GLargeMapControl,GOverviewMapControl" nodeMovable="true" level="7" />
Google マップ・ビューと関連して使用できる他の唯一の JViews コンポーネントは、凡例ツールです。
これにより、ユーザーは、どのオーバーレイ・レイヤーを表示するかを選択できます。
他のすべての JViews インタラクターおよび
従属ビューは無効です。
JViews 地図レイヤー・ツール
と Google マップ・ビューの使用
<jvmf:layerTool id="layerTool" title="Google View Layers" viewId="gmapID" enabled="true" />