Visualforce 開発者ガイド
jApex での地図データの作成例
カスタムクエリの実行、近くの場所の検索、結果の絞り込みや変換を行う場合、または Visualforce の標準コントローラから返される結果を使用できない場合は、Apex で場所データを作成します。
Apex コードでは、返される結果を完全に制御して、地図やマーカーに使用できます。また、Apex を使用して、Salesforce 外から結果を返すこともできます。
次のページには、ユーザの現在の場所に最も近い最大 10 個の倉庫が表示されます。
このページには、3 つの重要なセクションがあります。
- 先頭にある JavaScript ブロックは、ユーザの現在の場所を要求するブラウザの組み込み機能へのアクセス方法を示します。このコードが表示されるフォーム項目を更新します。もちろん非表示のフォーム項目を使用することもでき、その場合は未加工の緯度と経度が低い精度で表示されるのを簡単に回避できます。
- 最初の <apex:pageBlockSection> には、ユーザの場所を POSTBACK 要求に送信するための簡単なフォームが含まれています。説明のため、フォームが表示されクリックを必要とする設定になっていますが、これは必須ではありません。
- 2 番目の <apex:pageBlockSection> は、わずか 5 行のコードを必要とする簡単な地図です。複雑な点は、Apex コントローラでプロパティにアクセスする {!locations} 式のみです。
{!resultsAvailable} 式の値を取得する rendered 属性の使用に注目してください。この式は別の Apex プロパティであり、rendered 属性と共に使用すると、地図に配置できる場所がなければ、地図セクションが非表示になります。
次に、上記のページをサポートする Apex コントローラを示します。
このコントローラの詳細および Visualforce ページでどのように動作するかを習得してください。
- locations プロパティは、Map<String,Double> 要素のリストです。このリストには、<apex:mapMarker> コンポーネントで直接使用できる形式で場所データが保持されます。
- currentPosition プロパティは、ページのフォームから送信された位置情報を取得します。このプロパティにも、空のフォームが送信された場合には有効なデフォルト値が提供されます (堅牢な実装にすることで、フォーム入力に対するエラーチェックが強化されます)。
- Visualforce マークアップの以前の説明で記載した resultsAvailable プロパティ。
- findNearby アクションメソッドは、[Go!] <apex:commandButton> が押されるとコールされます。このメソッドは、カスタム SOQL クエリの実行、locations プロパティ形式への結果の変換など、すべての処理を行います。
<apex:mapMarker> の title 属性を使用して追加の情報 (倉庫の名前など) を提供する場合は、いくつかのオプションがあります。メソッドが sObject を返す場合は、Visualforce マークアップで適切な項目を参照できます。この例と同様に、新しいオブジェクトを直接作成する場合は、場所を示す地図オブジェクトとタイトル文字列を組み合わせる内部クラスを作成できます。これにより内部クラスオブジェクトのコレクションがページに返されます。