Visualforce 開発者ガイド
japex:map
対話型で JavaScript ベースの地図を表示します。ズームやパンの操作ができるだけでなく、Salesforce または他のデータに基づいてマーカーを表示する機能もあります。
<apex:map> だけでは、中心点に対しても地図のマーカーは表示されません。最大 100 個のマーカーを表示するには、子 <apex:mapMarker> コンポーネントを追加します。
取引先所在地を表示する市街地図
1<apex:page standardController="Account">
2
3 <!-- This page must be accessed with an Account Id in the URL. For example:
4 https://<salesforceInstance>/apex/AccountLocation?id=001D000000JRBet -->
5
6 <apex:pageBlock >
7 <apex:pageBlockSection title="{! Account.Name } Location">
8
9 <!-- Display the text version of the address -->
10 <apex:outputPanel >
11 <apex:outputField value="{!Account.BillingStreet}"/><br/>
12 <apex:outputField value="{!Account.BillingCity}"/>,
13 <apex:outputField value="{!Account.BillingState}"/>
14 <apex:outputField value="{!Account.BillingPostalCode}"/><br/>
15 <apex:outputField value="{!Account.BillingCountry}"/>
16 </apex:outputPanel>
17
18 <!-- Display the address on a map -->
19 <apex:map width="600px" height="400px" mapType="roadmap" zoomLevel="17"
20 center="{!Account.BillingStreet},{!Account.BillingCity},{!Account.BillingState}">
21 </apex:map>
22
23 </apex:pageBlockSection>
24 </apex:pageBlock>
25
26</apex:page>属性
| 属性名 | 属性型 | 説明 | 必須かどうか | API バージョン | 通用範囲 |
|---|---|---|---|---|---|
| center | Object | 地図の中心点の場所を指定します。中心点を定義するには、複数の方法があります。
<apex:map> に子 <apex:mapMarker> タグがない場合、この属性は必須です。 center が設定されていないと、すべてのマーカーが表示されるように地図の中心点が設定されます。 |
32.0 | ||
| height | String | 地図の高さ。利用可能な縦方向のスペースのパーセント (height="50%" など)、またはピクセル数 (height="200px" など) のいずれかで表されます。 注意: この値は、地図用に生成された HTML に渡されます。無効な値を指定すると、地図が表示されない場合があります。 |
はい | 32.0 | |
| id | String | ページの他のコンポーネントがこのコンポーネントを参照できるようにする識別子。 | 32.0 | グローバル | |
| mapType | String | 表示する地図の種類。次のいずれかである必要があります。
|
32.0 | ||
| rendered | Boolean | コンポーネントをページに表示するかどうかを指定する boolean 値。指定されていない場合、この値はデフォルトの「true」に設定されます。 | 32.0 | ||
| scrollBasedZooming | Boolean | 地図でスクロールホイールによるズームを有効にするかどうかを指定する boolean 値。指定されていない場合、この値はデフォルトの true に設定されます。 | 37.0 | ||
| showOnlyActiveInfoWindow | Boolean | 地図上に複数の情報ウィンドウを同時に表示できるかどうかを指定する Boolean 値。指定しない場合、この値はデフォルトの true になり、同時に表示される情報ウィンドウは 1 つのみになります。つまり、別のマーカーをクリックすると、最初の情報ウィンドウが閉じ、新しい情報ウィンドウが表示されます。 | 34.0 | ||
| width | String | 地図の幅。利用可能な横方向のスペースのパーセント (width="50%" など)、またはピクセル数 (width="200px" など) のいずれかで表されます。 注意: この値は、地図用に生成された HTML に渡されます。無効な値を指定すると、地図が表示されない場合があります。 |
はい | 32.0 | |
| zoomLevel | Integer | 地図の初期ズームレベ���。整数 0 ～ 18 で定義されます。値が大きいほど、ズームイン率が高くなります。 子 <apex:mapMarker> タグがあり、zoomLevel が設定されていない場合、地図はすべてのマーカーが表示されるようにズームされ、中心点が設定されます。指定せずにマーカーもない場合、デフォルト値は 15 です。 |
32.0 |