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

Location クラス

地理位置情報複合項目のコンポーネント項目にアクセスするためのメソッドが含まれます。

名前空間

system

使用方法

これらの各メソッドも参照のみのプロパティと同等です。getter メソッドごとに、ドット表記を使用してプロパティにアクセスできます。たとえば、myLocation.getLatitude()myLocation.latitude と同じです。

ドット表記を使用して、親項目にある複合項目のサブ項目に直接アクセスすることはできません。代わりに、親項目を Location 型の変数に割り当てて、そのコンポーネントにアクセスします。

1Location loc = myAccount.MyLocation__c;
2Double lat = loc.latitude;

Salesforce での「Location」は、Location 標準オブジェクトを参照している場合もあります。Apex で Location オブジェクトを参照する場合、標準の Location 複合項目と混乱しないように、常に Location の代わりに Schema.Location を使用します。同じスニペット内で Location オブジェクトと Location 標準項目の両方を参照する場合、項目には System.Location、オブジェクトには Schema.Location を使用してこの 2 つを区別できます。

重要

1// Select and access the Location field. MyLocation__c is the name of a geolocation field on Account.
2Account[] records = [SELECT id, MyLocation__c FROM Account LIMIT 10];
3for(Account acct : records) {
4   Location loc = acct.MyLocation__c;
5   Double lat = loc.latitude;
6   Double lon = loc.longitude;
7}
8
9// Instantiate new Location objects and compute the distance between them in different ways.
10Location loc1 = Location.newInstance(28.635308,77.22496);
11Location loc2 = Location.newInstance(37.7749295,-122.4194155);
12Double dist = Location.getDistance(loc1, loc2, 'mi');
13Double dist2 = loc1.getDistance(loc2, 'mi');

Location のメソッド

Location のメソッドは次のとおりです。

getDistance(toLocation, unit)

この場所と指定の場所との間の距離を、半正矢公式の近似値と指定された単位を使用して計算します。

署名

public Double getDistance(Location toLocation, String unit)

パラメーター

toLocation
型: Location
現���の Location から距離を計算する Location
unit
型: String
使用する距離の単位: mi または km

戻り値

型: Double

getDistance(firstLocation, secondLocation, unit)

指定された 2 つの場所の間の距離を、半正矢公式の近似値と指定された単位を使用して計算します。

署名

public static Double getDistance(Location firstLocation, Location secondLocation, String unit)

パラメーター

firstLocation
型: Location
距離の計算の使用される 2 点のうちの最初の場所。
secondLocation
型: Location
距離の計算の使用される 2 点のうちの 2 番目の場所。
unit
型: String
使用する距離の単位: mi または km

戻り値

型: Double

getLatitude()

この地理位置情報の緯度項目を返します。

署名

public Double getLatitude()

戻り値

型: Double

getLongitude()

この地理位置情報の経度項目を返します。

署名

public Double getLongitude()

戻り値

型: Double

newInstance(latitude, longitude)

指定された緯度と経度を使用して、Location クラスのインスタンスを作成します。

署名

public static Location newInstance(Decimal latitude, Decimal longitude)

パラメーター

latitude
型: Decimal
longitude
型: Decimal

戻り値

型: Location