MatchingMapは、求人施設や求職者として設定するオブジェクトのレコードにGoogle Geocoding APIで取得した地理位置情報(緯度・経度)を保存する地理位置情報取得バッチを提供しています。

※ 本機能は、Salesforce標準のデータインテグレーション機能を使用する場合は使用する必要はありません。

1. 地理位置情報取得バッチの設定画面を開く

地理位置情報取得バッチの定期実行は、「MatchingMap」アプリケーション「MatchingMap管理」タブ内の「位置情報取得バッチ設定」タブから設定します。

「位置情報取得バッチ設定」タブ内は、地理位置情報取得対象として追加したオブジェクト設定ごとのタブを含みます。

設定が一つもなく新規に開いた場合は、以下のように「新しい設定」のタブのみが表示された状態で表示されます。

2. 位置情報を取得するオブジェクトを設定する

Google Geocoding APIを利用して地理位置情報をセットするオブジェクトを設定します。

2-1. 地理位置情報取得対象のオブジェクトを選択

「地位位置情報を取得するオブジェクト」で、地理位置情報をセットするオブジェクトを選択します。

オブジェクトを選択すると以下のプルダウンリストで、選択したオブジェクトの項目を選択できるようになります。

また、オブジェクトにレコードタイプが複数存在する場合は、対象とするレコードタイプを選択することができます。

「すべてのレコード」を選択している場合は、レコードタイプに依らずすべてのレコードが対象となります。

「レコードタイプ」を指定を選択すると、オブジェクトに定義されているレコードタイプを選択可能になり、「選択済みのレコードタイプ」に追加されたレコードタイプが設定されたレコードのみが地位位置情報の取得対象となります。

上記の場合は、レコードタイプ「Bussiness Account」のレコードのみが対象となり、「個人取引先」またはレコードタイプが空のレコードは対象外となります。

2-2. 住所および地位位置情報を保存する項目を選択

Google Geocoding APIを呼び出す際にパラメータとして渡す住所の値を設定します。

Salesforceで緯度経度を保持する項目のデータ型には、住所型と地理位置情報型があります。地理位置情報型は緯度経度のみで住所情報が含まれないため、カスタムオブジェクトなどで地理位置情報を選択する場合は、住所のテキストを含む項目を別途選択する必要があります。

① 住所型の項目を使用する場合

取引先や取引先責任者などの標準オブジェクトには、住所情報と地位位置情報の両方を保持できる住所型の項目があります。

「住所項目を使用」を選択し、「住所項目」プルダウンで住所型の項目を選択します。

② 地理位置情報型の項目を使用する場合

カスタムオブジェクトには住所型の項目が使えませんので、テキスト型の住所項目と地位位置情報型の項目を組み合わせて使用します。

「地理位置情報型項目+テキスト型項目を使用」を選択し、「位置情報項目」のプルダウンで地理位置情報を保持する項目を、「住所(テキスト)項目」のプルダウンで住所を保持する項目を選択します。

「位置情報型項目」に設定する項目には、データ型「地理位置情報型」の項目を設定しますが、「緯度および経度表示の表記法」は「少数」を、「小数点の位置」は「7」を設定します。

「住所(テキスト)項目」は、「テキスト型」、「テキストエリア型」に加えテキストを返す「数式」の項目を選択することが可能です。求人施設オブジェクトが取引先を参照するカスタムオブジェクトの場合、数式で取引先の住所を参照する数式を利用できます。

2-3. 地理位置情報取得結果を保存する項目を選択

Google Geocoding APIが返す結果を保存する項目を選択します。

「位置情報取得結果を保持する項目」は「住所項目」または「住所(テキスト)項目」で選択した項目が項目履歴管理の対象として設定されていない場合、地理位置情報取得対象レコードかどうかの判定に使用されるため設定が必須となります。

また、地理位置情報取得バッチを即時実行する際も、対象レコードの絞り込みにも使用されます

詳細は、「3. 地理位置情報取得バッチ定期実行の有効化」を参照ください。

項目には、地理位置情報の取得に成功した場合は「OK」がセットされ、エラーの場合はエラーメッセージが保存されます。エラーメッセージは最大255文字ですので、テキスト型で文字数255の項目を作成して選択してください。

地理位置情報取得バッチの実行結果はメールでも通知されますが、メールに含まれるエラーのレコード数は100件までです。それを超えるエラー以上ある場合はこの地理位置情報取得結果に設定した項目で検索し、各レコードの住所の値を見直しをする必要があります。

2-4. 地理位置情報精度を保存する項目を選択

Google Geocoding APIから取得した地位位置情報の精度をレコードに記録します。精度はレポートなどで表示し住所の見直しに使用できます。

テキスト型で文字数255の項目を作成し、「位置情報精度を保存する項目」で選択します。

位置情報精度を保存する項目には、以下のいずれかの値がセットされます。

  • 「ROOFTOP」: 正確な地理位置情報。住所の番地まで特定できた場合。

  • 「RANGE_INTERPOLATED」: 2番目の精度、交差点など正確に特定可能な2地点から補正された近似値。

  • 「GEOMETRIC_CENTER」: 特定可能な道路や地域の中心点。

  • 「APPROXIMATE」: 曖昧な結果。住所の見直しが必要。

  • 「ZERO_RESULTS」: 住所から地理位置情報が取得できなかった場合 (※)。

※ 地理位置情報精度の値はGoogle Geocoding APIの応答に含まれる「geometry.location_type」の値を保存していますが、「ZERO_RESULTS」のみ異なり「status」の値をセットしています。

2-5. 地理位置情報取得対象とするかを表すチェックボックス項目を選択

オブジェクトのレコードの一部がMatchingMapで表示する対象ではない場合、例えば求人施設に取引先オブジェクトを設定していて、取引先には求人施設以外のレコードが含まれている場合、それらを地理位置情報取得対象から除外することができます。

オブジェクトにチェックボックス型の項目を用意し、それを「地理位置情報取得対象とするかを表すチェックボックス項目」で選択します。

設定した項目の値が「True」のレコードのみ地理位置情報取得対象となります。

例えば、上記の例で求人施設を表すレコードタイプ「求人施設 (WorkPlace)」であった場合、レコードタイプ名が「WorkPlace」の場合にTrueとなる数式項目を用意します。

3. 地理位置情報取得バッチ定期実行の有効化

地理位置情報取得バッチの定期実行を有効化は、オブジェクト設定を保存した後「地理位置情報バッチ設定 」セクションで設定します。

3-1. 定期実行の有効化

地位位置情報バッチを定期実行する場合は、「10分毎の位置情報取得バッチ定期実行の有効化」のスイッチをオンにします。

定期実行時には、以下の条件を満たすレコードが地理位置情報を取得する対象となります。

①「住所項目」、または「住所(テキスト)項目」に対して、項目履歴管理を有効にしている場合

  • 前回実行日時以降に住所項目が変更されたレコード

※ 住所項目にテキストを返す数式を指定している場合、数式から参照される項目に対して項目履歴管理を有効化しても変更を捕捉できません。

②「住所項目」、または「住所(テキスト)項目」に対して、項目履歴管理を有効にしていない場合

  • 地理位置情報結果項目に設定した項目の値が空のレコード

※ 住所項目が変更された場合に地理位置情報結果項目を空にするフローを実装するなどすると便利です。

初回実行時は住所を持つ全レコードに対して実行されます。Matching Mapで利用しているGoogle Geocoding APIは1000件につき$5の費用が発生します(詳細)。ご注意くださ

3-2. 地位位置情報バッチを即時実行

地理位置情報取得バッチを即時実行することもできます。MatchingMap導入時にすぐに地理位置情報取得を試したい場合や、地理位置情報取得に失敗したレコードの住所を修正して再実行する際にご利用ください。

即時実行するには、以下の「即時実行」ボタンをクリックします。

即時実行時は、以下の条件を満たすレコードが地理位置情報を取得する対象となります。定期実行時とするレコードの絞り込み条件が異なりますので注意ください。

  • 「地理位置情報取得結果」に指定した項目の値が、空またはエラーステータのレコード

  • 「地理位置情報取得結果」の項目が設定されていない場合は住所を持つ全レコード

初回実行時は、定期実行と同じく住所を持つ全レコードに対して実行されます。

4. オブジェクト設定の削除

設定しているオブジェクトをMatchingMapで使用することがなくなった場合は以下の、「設定の解除・削除 」セクションの「削除実行」をクリックします。

定期実行が有効化されている場合は、定期実行の登録を解除した後、オブジェクトの設定が削除されます。

5. 地理位置情報取得バッチ完了通知の設定

デフォルトでは、地理位置情報取得バッチは処理完了時に処理対象レコードが1つ以上存在した場合には成否に関わらず実行者に完了通知のメールを送信します。

すべてのレコードが正常だった場合のメールを通知が不要であれば、「システム設定」タブの「通知設定」セクションの「地理位置情報バッチ正常完了時も通知メールを受け取る」を「オフ」にします。

回答が見つかりましたか?