Loading
Salesforce から送信されるメールは、承認済ドメインからのみとなります続きを読む

Maps のジオコーディングに関する FAQ

公開日: May 1, 2026
説明

Salesforce Maps には、レコードの緯度と経度をジオコーディングすることで Maps 上にマーカーを正確に配置できる独自のメカニズムがあります。
解決策


Maps のジオコーディングに関するよくある質問 (FAQ) を次に示します。


注意: ジオコーディングは非同期サービスであり、関連項目の更新には遅延が発生する場合があります。 


 

ジオコーディングとは何ですか? どういう仕組みなのでしょうか?


ジオコーディングとは、番地などの入力テキストを取得して、地表の位置情報のプロットに使用できる緯度と経度を返す処理のことです。

Salesforce Maps では API を使ってジオコーディング機能を操作しています。住所がジオコーダーに送信されると、その住所に対して最も正確な緯度と経度が特定され、応答を返します。

Salesforce Maps は、構造化されていない部分的または完全な住所を処理します。カスタム住所項目をジオコーディングする際、Salesforce Maps はこの自由テキストのクエリパラメータを活用して、ジオコーディングサービスへのリクエストを行います。このリクエストは構造化されていません。つまり、どの文字列が住所のどの要素を表すかを示さずに文字列のリストを送信していることになります。

リクエストは、ジオコーダーサービスに次のフォーマットで送信されます。

https://geocoder.mapanything.io/6.2/geocode.json?searchtext=200 S Mathilda Sunnyvale CA&gen=9


上の例では、URL が復号されて空白を示しています。検索テキストのパラメータは文字列値で、これは住所の構成要素です。

  • 200 = 番地
  • S Mathilda = 町名
  • Sunnyvale = 市
  • CA = 州

ジオコーダーのリクエストに渡される文字列値は、次の 2 つのいずれかの方法で構成されています。

例:
商品にプロットされているレイヤーをジオコーディングする場合、文字列はカンマで区切られます。

  • 200, S Mathilda, Sunnyvale, CA 94086

ジオコーディングが一括で処理される場合、住所はカンマなしで送信されます。

  • 200 S Mathilda Sunnyvale CA 94086


一般的には、リクエストで渡されるテキストパラメータが多いほど (例: CA や 94086)、マッチング品質の信頼度が高くなります。

注意: 住所に「and」という単語が含まれる場合、稀にジオコーディングが正確に実施されない場合があります。住所からこの単語を削除するか、「Set Verified Location in Maps (検証済みの位置情報を設定)」の機能を使用してください。

 

Salesforce の標準の住所項目とカスタム住所項目はどのようにジオコーディングされますか?


標準の住所項目
Salesforce 標準のアカウント請求先住所またはアカウント配送先住所を使用している場合、標準のデータ連携ルールに従ってレコードをジオコーディングし、住所項目に更新があった場合に座標を更新する必要があります。

組織のデータ連携ルールが有効になっている場合、特定の標準オブジェクトのレコードは data.com でジオコーディングされます。
データ連携ルールは以下にのみ適用されます。

  • アカウント請求先住所
  • アカウント配送先住所
  • 取引先郵送先住所
  • リードの住所

データ連携ルールの有効化についての詳細は、記事データサービスのデータインテグレーションルールの有効化」を参照してください。

カスタム住所項目
カスタム住所項目は、Salesforce Maps でジオコーディングされます。ベースオブジェクトにカスタム住所項目を使用している場合、そのレコードの住所項目を更新するには、レコードの緯度と経度をクリアして再度ジオコーディングするオートメーションを作成する必要があります。
 

 

Salesforce Maps ではどのようなジオコーディングの標準を採用していますか?

Salesforce Maps の対象範囲のレベルは、国によって異なります。ジオコーダーの対象範囲についての詳細は、「Salesforce Maps Geocoder Coverage (Salesforce Maps のジオコーダーの対象範囲)」を参照してください。この対象範囲は、ジオコーディングのカスタム住所項目のみに基づくものです。

基本的には、入力された住所が詳しいほど、結果の精度は高くなります。すべてのジオコーダーの基礎には、渡されたパラメータの正しい構文を特定できる解析エンジンがあるため、データベースに対して正確にクエリを実行できます。このケースで言えば、これは文字列の集まりです。

送信したジオコーディングリクエストは構造化されていないため、結果の精度は送信されたパラメータの数と質に大きく左右されます。

ジオコーディングサービスへのリクエストでは、自由テキストのクエリパラメータを使用します。つまりこのジオコーダーの解析エンジンは、構造化されていない文字列のパラメータを取得し、その住所の正しい構文を特定し、適切にクエリを実行するということです。ジオコーダーは、国ごとの適切な住所フォーマットを考慮する必要があります。Salesforce のデフォルトの住所フォーマットは、米国方式です。

自由テキストのクエリパラメータは、次の例を確認してください。

  • 2, first ave, Australia
  • 2, First Avenue, Belfield NSW, Australia
  • 200, S Mathilda, Sunnyvale, CA
  • 360, Pharr Rd NE, Atlanta, GA, 30305

ジオコーダーは、この情報を使って緯度と経度を特定します。リクエストのパラメータが多いほど、結果の精度は高くなります。

例:

  • 2, first ave, Australia
  • 2, First Avenue, Belfield NSW, Australia

2 番目の例には、「Belfield」と「Avenue」が追加されているため、結果の精度はより高くなります。これらの追加情報がなければ、ジオコーダーは正確な結果を返すことができません。オーストラリアには「2 First Ave」を含む住所が数多く存在するためです。

よく知らない住所に関しては、その国でのフォーマットが正しいかどうかを判断したり、住所の質のレベルを理解したりするのは困難である可能性があります。ジオコーダーは、渡されたパラメータに基づいて、どのレベルの結果を出せるかを特定することもできます。この例では、オーストラリアのさまざまな都市に n 件の「2 First Avenues」が存在する可能性があります。したがって、結果は正しくない可能性があります。

また国によってジオコーダーの対象範囲のレベルは異なるため、これも住所と座標の関連付けに影響します。対象範囲についての詳細は、「Salesforce Maps Geocoder Coverage (Salesforce Maps のジオコーダーの対象範囲)」を参照してください。特に国や地域の一部が対象範囲に含まれない場合、正確な緯度と経度の結果を取得できない可能性があります。

 
 

更新頻度はどのくらいですか? 

  • ジオコーダーは四半期ごとに更新されます。
  • 送信された変更が適用されるまでの期間は、次回の四半期リリースの日時によって変わります。新しい建物の住所は、本番環境に反映されるまで数か月かかる場合があります。これは、このジオコーディングサービスがセルフホスト型であり、Salesforce がベンダーに設定している更新頻度が四半期ごとであるためです。

 

ジオコーディングを正確に実施するためのベストプラクティスは?


1. 国名や州名なしで、さまざまな地域に存在する都市の名前だけを入力すると、ジオコーダーは正しい結果を返さない可能性があります。

たとえば、国名や州名なしで「Monterrey」と入力すると、ジオコーダーは誤った結果を返すことがあります。これは「Monterrey」という都市が、米国カリフォルニア州、コロンビア、スペインに存在するためです。

2. 住所項目には、不要な情報を入力しないでください。

住所データを Salesforce にインポートした場合、ジオコーダーが処理できないレコードが余分に含まれていることがあります。例:

Attn Finance Director
77 Center Drive
Charlotte, NC 28217

3. 住所に対して正確な国名を入力してください。

たとえば、次の住所には誤った国名が含まれているため、ジオコーダーは正確な結果を返すことができません。

Salesforce Maps
77 Center Drive
Charlotte, NC 28217
カナダ

4. 国名や州名を繰り返して入力しないでください。

たとえば、次のように州名を繰り返して入力すると、ジオコーダーは正確な結果を返すことができません。

Salesforce Maps
77 Center Drive
Charlotte, NC 28217
North Carolina, USA, US NC 28217

5. ジオコーダーから最も正確な結果を得るには、現地の住所表記を使用してください。キリル文字、表語文字、表意文字を使用する言語でない限り、住所をアメリカ英語に翻訳しないでください。「A ~ Z」および「0 ~ 9」以外の文字は応答を返す可能性がありますが、サポートされていません。


Porscheplatz 1
70435 Stuttgart
Deutschland

6. 住所には、アパート名、マンション名、部屋番号を含めないでください。

住所項目にそれらの情報を追加すると、Salesforce Maps でプロットの問題が発生する可能性があります。アパート名、マンション名、部屋番号は、レコード内の別の項目に追加することを推奨します。例:

77 Center Drive,
Suite 400,
Charlotte, NC 28217
 

緯度と経度の項目はいつ更新されますか?

 

  • 初めてレコードがジオコーディングされると (これは、レイヤーのプロット時またはバッチの実行時に行われます)、Salesforce Maps によって空の緯度と経度の項目に入力され、レコードページに保存され、レコードが変更されます。
  • レコードの住所が変更された場合は、レコードの緯度または経度の値をクリアするフローを組織内で設定すると、Maps のジオコーディングエンジンがレコードを再ジオコーディングできるようになります。
  • 空または「Null」の緯度または経度の項目は、クエリで明確に除外されない限りジオコーディングされます。
  • クエリをプロットすると、そのクエリ内のすべてのレコードは、レコードにまだ緯度と経度の座標が設定されていない場合、ジオコーディングされます。
  • 新しいレコードが SFDC に追加された場合、レコードがマップにプロットされるか、レコードに対してジオコーディングバッチが実行されるまで、そのレコードの緯度と経度の項目は更新されません。
  • 座標をレコードに保存したり、プロセスやトリガーを呼び出したりできないオブジェクトのオートメーションは、再検討する必要があります。


 

検証済みの緯度または経度の項目がある場合はどうなりますか?

 

  • 検証済みの緯度と経度の項目が入力されている場合、Salesforce Maps はこれらの情報を標準の緯度や経度の項目の代わりに使用してマップ上にピンを配置します。
  • 一括アクションを使用して座標をクリアすると、検証済みの項目をクリアするかどうかを尋ねるメッセージが表示されます。
ナレッジ記事番号

000380853

 
読み込み中
Salesforce Help | Article