この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

apex: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}"/>, &nbsp;
13        <apex:outputField value="{!Account.BillingState}"/> &nbsp;
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 地図の中心点の場所を指定します。中心点を定義するには、複数の方法があります。
  • 住所を表す文字列。たとえば、「1 Market Street, San Francisco, CA」のようになります。住所は自動的に地理コード化され、正確な緯度と経度が決まります。
  • 場所の座標を指定する latitude および longitude 属性を含む JSON オブジェクトを表す文字列。たとえば、「{latitude: 37.794, longitude: -122.395}」のようになります。
  • 場所の座標を指定する latitude および longitude キーを含む、Map<String, Double> 型の Apex 地図オブジェクト。

<apex:map> に子 <apex:mapMarker> タグがない場合、この属性は必須です。

center が設定されていないと、すべてのマーカーが表示されるように地図の中心点が設定されます。

32.0
height String 地図の高さ。利用可能な縦方向のスペースのパーセント (height="50%" など)、またはピクセル数 (height="200px" など) のいずれかで表されます。

注意: この値は、地図用に生成された HTML に渡されます。無効な値を指定すると、地図が表示されない場合があります。

はい 32.0
id String ページの他のコンポーネントがこのコンポーネントを参照できるようにする識別子。 32.0 グローバル
mapType String 表示する地図の種類。次のいずれかである必要があります。
  • ハイブリッド
  • roadmap
  • satellite
指定されていない場合、この値はデフォルトの「roadmap」に設定されます。
32.0
rendered Boolean コンポーネントをページに表示するかどうかを指定する boolean 値。指定されていない場合、この値はデフォルトの「true」に設定されます。 32.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