Location クラス (Search)
入力パラメータとして、検索要求の地理的な位置 (Location.Longitude と Location.Latitude) および範囲 (Location.Radius) を指定します。出力パラメータとして、PhoneBook 検索結果または QueryLocation 検索結果の緯度と経度を返します。
構文
public Location ()
プロパティ
名前 | 説明 |
---|---|
Locaiton の Latitude コンポーネントを指定する、または返します。Latitude の有効な値の範囲は、-90 ~ 90 です。正確な結果を得るには、値を 10 進数表現の緯度の値に変換する必要があります (「解説」を参照してください)。Double。 |
|
Locaiton の Longitude コンポーネントを指定する、または返します。Longitude の有効な値の範囲は、-180 ~ 180 です。正確な結果を得るには、値を 10 進数表現の経度の値に変換する必要があります (「解説」を参照してください)。Double。 |
|
Locaiton の Radius コンポーネントを指定する、または返します。Radius の有効な値の範囲は、0 ~ 250 マイルで、既定値は 5 マイルです。Radius の入力値にかかわらず、Double 値の 5 が常に返されます。Double。 |
解説
この情報は、SourceType.Web の SourceRequest による Web での地域の検索結果、SourceType.PhoneBook の SourceRequest による地域の電話帳のエントリ、および SourceType.QueryLocation の SourceRequest による位置情報を返すのに使用されます。各 PhoneBook 検索結果または QueryLocation 検索結果には、それぞれ結果となる電話帳の一覧またはクエリの位置の緯度と経度が格納されている Location オブジェクトが含まれます。
SourceRequest タイプの Web または PhoneBook が指定され、Location が SearchRequest に指定され、かつ緯度と経度の入力フィールドに無効な値 (+- 90 より大きい緯度の値、+- 180 より大きい経度の値、人の住んでいない地域を示す値など) が含まれていると、Live Search Web サービスからほとんど結果が返されません。
SourceRequest タイプの PhoneBook が指定されず、Location が SearchRequest に指定されない場合、クエリが "キーワード 場所の名前" や "キーワード 郵便番号" の形式ではない場合、または Radius フィールドの入力値が非常に小さい Double 値の場合は、Live Search Web サービスからほとんど結果が返されません。