次の方法で共有


Search - Get Search Address Reverse Cross Street

緯度と経度の座標からクロスストリートの位置情報を取得するには、 を使用します。

Get Search Address Reverse Cross Street API は、緯度と経度の座標が指定されたときに、最も近いクロス ストリートを返す HTTP GET 要求です。 座標 (例: 37.786505、-122.3862) を人間が理解できるクロスストリートに変換する必要がある場合があります。 多くの場合、これは、デバイスまたはアセットから GPS フィードを受信し、座標が配置されているアドレスを知る必要があるアプリケーションをトラッキングする場合に必要です。 このエンドポイントは、特定の座標のクロスストリート情報を返します。

GET https://atlas.microsoft.com/search/address/reverse/crossStreet/{format}?api-version=1.0&query={query}
GET https://atlas.microsoft.com/search/address/reverse/crossStreet/{format}?api-version=1.0&query={query}&limit={limit}&heading={heading}&radius={radius}&language={language}&view={view}

URI パラメーター

名前 / 必須 説明
format
path True

ResponseFormat

応答の目的の形式。 値には json または xml のいずれかを指定できます。

api-version
query True

string

Azure Maps API のバージョン番号。

query
query True

number[]

緯度の後に経度 (例: "47.641268,-122.125679" など) で構成されるコンマ区切り文字列として指定された該当するクエリ。

heading
query

integer

道路のセグメントに沿って移動するための車両の方向見出しを度単位で指定します。 0 は North、90 は East など、値の範囲は -360 から 360 です。 有効桁数には、小数点以下 1 桁までを含めることができます

language
query

string

検索結果を返す言語。 サポートされている IETF 言語タグの 1 つである必要があります。大文字と小文字は区別されません。 指定した言語のデータが特定のフィールドで使用できない場合は、既定の言語が使用されます。

詳細については、「 サポートされている言語 」を参照してください。

limit
query

integer

返される応答の最大数。 既定値: 10、最小: 1、最大: 100

radius
query

integer

結果を定義された領域に制限するための半径 (メートル単位)

view
query

LocalizedMapView

View パラメーター ("user region" パラメーターとも呼ばれます) を使用すると、地政学的に紛争が発生している地域の特定の国/地域の正しいマップを表示できます。 このようなリージョンのビューは国や地域によって異なります。また、View パラメーターを使用すると、アプリケーションがサービスを提供する国/地域に必要なビューにアプリケーションを準拠できます。 既定では、View パラメーターは、要求で定義していない場合でも "Unified" に設定されます。 ユーザーの場所を特定し、その場所を正しく View パラメーターを設定するのはユーザーの責任です。 または、要求の IP アドレスに基づいてマップ データを返す 'View = Auto' を設定することもできます。 Azure Mapsの View パラメーターは、マップ、画像、その他のデータ、Azure Maps経由でアクセスする権限を持つ第三者のコンテンツが利用可能になる国/地域のマッピングに関するものを含む、適用される法律に準拠して使用する必要があります。 例: view=IN。

詳細については、「 サポートされているビュー」 を参照し、使用可能なビューを参照してください。

要求ヘッダー

名前 必須 説明
x-ms-client-id

string

Microsoft Entra ID セキュリティ モデルと組み合わせて使用するアカウントを指定します。 Azure Maps アカウントの一意の ID を表し、Azure Maps管理プレーン アカウント API から取得できます。 Azure MapsでMicrosoft Entra IDセキュリティを使用するには、次の記事を参照してください。

応答

名前 説明
200 OK

ReverseSearchCrossStreetAddressResult

OK

Other Status Codes

ErrorResponse

予期しないエラーが発生しました。

セキュリティ

AADToken

これらは OAuth 2.0 フロー Microsoft Entraです。 Azure ロールベースのアクセス制御と組み合わせて使用すると、Azure Maps REST API へのアクセスを制御できます。 Azure ロールベースのアクセス制御は、1 つ以上のAzure Mapsリソース アカウントまたはサブリソースへのアクセスを指定するために使用されます。 REST API に対する 1 つ以上のアクセス許可で構成される組み込みロールまたはカスタム ロールを使用して、任意のユーザー、グループ、またはサービス プリンシパルにアクセス権 Azure Mapsを付与できます。

シナリオを実装するには、 認証の概念を表示することをお勧めします。 要約すると、このセキュリティ定義は、特定の API とスコープに対するアクセス制御が可能なオブジェクトを使用してアプリケーションをモデル化するためのソリューションを提供します。

注意

  • このセキュリティ定義では、 ヘッダーを使用して、x-ms-client-idアプリケーションがアクセスを要求しているリソースAzure Maps示す必要があります。 これは、 Maps 管理 API から取得できます。
  • Authorization URLは、Azure パブリック クラウド インスタンスに固有です。 ソブリン クラウドには、固有の承認 URL とMicrosoft Entra ID構成があります。
  • Azure ロールベースのアクセス制御は、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーンから構成されます。
  • Azure Maps Web SDK を使用すると、複数のユース ケースに対するアプリケーションの構成ベースのセットアップが可能になります。
  • Microsoft ID プラットフォームの詳細については、「Microsoft ID プラットフォームの概要」を参照してください。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

これは、Azure portalでAzure Maps アカウントを作成するとき、または PowerShell、CLI、Azure SDK、または REST API を使用するときにプロビジョニングされる共有キーです。

このキーを使用すると、すべてのアプリケーションがすべての REST API にアクセスできます。 つまり、このキーは、発行されたアカウントのマスター キーとして使用できます。

公開されているアプリケーションの場合は、機密クライアント アプリケーションのアプローチを使用して、キーを安全に格納できるように、Azure Maps REST API にアクセスすることをお勧めします。

型: apiKey
/: query

SAS Token

これは、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して、Azure 管理プレーンを介して、Azure Maps リソースの List SAS 操作から作成される共有アクセス署名トークンです。

このトークンを使用すると、すべてのアプリケーションが Azure ロールベースのアクセス制御を使用してアクセスし、特定のトークンに使用される有効期限、レート、およびリージョンをきめ細かく制御できます。 つまり、SAS トークンを使用して、アプリケーションが共有キーよりもセキュリティで保護された方法でアクセスを制御できるようにします。

公開されているアプリケーションの場合、 Map アカウント リソース で許可される配信元の特定の一覧を構成して、レンダリングの不正使用を制限し、SAS トークンを定期的に更新することをお勧めします。

型: apiKey
/: header

Search address of the nearest intersection/crossroad

要求のサンプル

GET https://atlas.microsoft.com/search/address/reverse/crossStreet/json?api-version=1.0&query=37.337,-121.89

応答のサンプル

{
  "summary": {
    "numResults": 1,
    "queryTime": 41
  },
  "addresses": [
    {
      "address": {
        "streetName": "East Santa Clara Street & North 2nd Street",
        "crossStreet": "East Santa Clara Street",
        "municipalitySubdivision": "San Jose, Downtown San Jose",
        "municipality": "San Jose",
        "countrySecondarySubdivision": "Santa Clara",
        "countryTertiarySubdivision": "San Jose",
        "countrySubdivisionCode": "CA",
        "postalCode": "95113",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "East Santa Clara Street & North 2nd Street, San Jose, CA 95113",
        "countrySubdivisionName": "California"
      },
      "position": "37.33666,-121.88951"
    }
  ]
}

定義

名前 説明
Address

結果のアドレス

BoundingBoxCompassNotation

場所の境界ボックス。

Entity

境界ボックスのエンティティ型ソース。 逆ジオコーディングの場合、これは常に位置と等しくなります。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

LatLongPairAbbreviated

短い名前 'lat' & 'lon' を使用して緯度と経度として表される場所。

LocalizedMapView

View パラメーター ("user region" パラメーターとも呼ばれます) を使用すると、地政学的に紛争が発生している地域の特定の国/地域の正しいマップを表示できます。 このようなリージョンのビューは国や地域によって異なり、View パラメーターを使用すると、アプリケーションが提供する国/地域に必要なビューにアプリケーションを準拠できます。 既定では、要求で定義していない場合でも、View パラメーターは "Unified" に設定されます。 ユーザーの場所を特定し、その場所を正しく View パラメーターを設定するのはユーザーの責任です。 または、要求の IP アドレスに基づいてマップ データを返す 'View = Auto' を設定することもできます。 Azure Mapsの View パラメーターは、マップ、画像、その他のデータ、Azure Maps経由でアクセスする権限を持つ第三者のコンテンツが利用可能になる国/地域のマッピングに関する法律を含む、適用される法律に準拠して使用する必要があります。 例: view=IN。

詳細については、「 サポートされているビュー 」を参照し、使用可能なビューを参照してください。

QueryType

返されるクエリの種類: NEARBY または NON_NEAR。

ResponseFormat

応答の目的の形式。 値には json または xml を指定できます。

ReverseSearchCrossStreetAddressResult

このオブジェクトは、アドレス逆引きクロスストリート呼び出しが成功したSearchから返されます

ReverseSearchCrossStreetAddressResultItem

Search Address Reverse Cross Street 応答の Result オブジェクト

SearchSummary

Search API 応答の Summary オブジェクト。

Address

結果のアドレス

名前 説明
boundingBox

BoundingBoxCompassNotation

場所の境界ボックス。

buildingNumber

string

通りの建物番号。 非推奨です。代わりに streetNumber を使用してください。

country

string

国/地域名

countryCode

string

国 (注: これは国/地域名ではなく、2 文字のコードです)。

countryCodeISO3

string

ISO alpha-3 国コード

countrySecondarySubdivision

string

County

countrySubdivision

string

都道府県

countrySubdivisionCode

string

countrySubdivisionCode プレフィックスは countryCode ( countryCode-countrySubdivisionCode ) で、ハイフンは ISO 3166-2 コードを形成します。 例: テキサス州の場合は TX、スコットランドの場合は SCT、オンタリオ州の場合は ON です。

countrySubdivisionName

string

国/地域管理階層の第 1 レベルの完全名。 このフィールドは、countrySubdivision が省略形で表示される場合にのみ表示されます。 米国、カナダ、英国でのみサポートされます。

countryTertiarySubdivision

string

名前付き領域

crossStreet

string

交差している通りの名前。

extendedPostalCode

string

拡張郵便番号 (利用可能時間は地域によって異なります)。

freeformAddress

string

結果の配信元の国/地域の書式設定規則に従って書式設定された住所行、または国/地域の場合は、その完全な国/地域名。

localName

string

管理単位を使用せずに、アドレス指定の目的で複数のアドレス指定可能オブジェクトをグループ化する地理的領域または地域の名前を表すアドレス コンポーネント。 このフィールドは、 プロパティのビルドに使用されます freeformAddresslocalName は、郵便番号の市区町村を表します。 場所に応じて、 localName は都市または町の一般的に知られている名前です。 都市または町の一般的に知られている名前の場合は、 ではなく municipalityを使用localNameします。

municipality

string

市区町村
注: municipality は、居住区を表します。 場所によっては、 municipality 市区町村の一般的に知られている名前と値が異なる場合があります。 市区町村の一般的に知られている名前の場合は、値の代わりにmunicipality値をlocalName使用することをお勧めします。

municipalitySubdivision

string

サブ / スーパーシティ

neighbourhood

string

地域は、都市または町内の地理的にローカライズされた地域であり、住民間の独特の特徴と社会的相互作用を持っています。

postalCode

string

郵便番号/郵便番号

routeNumbers

string[]

道路を明確に識別するために使用されるコード

street

string

通りの名前。 非推奨です。代わりに streetName を使用してください。

streetName

string

通りの名前。

streetNameAndNumber

string

通りの名前と番号。

streetNumber

string

通りの建物番号。

BoundingBoxCompassNotation

場所の境界ボックス。

名前 説明
entity

Entity

境界ボックスのエンティティ型ソース。 逆ジオコーディングの場合、これは常に位置と等しくなります。

northEast

string

北東緯度、境界ボックスの経度座標 (コンマ区切り浮動小数点数)

southWest

string

南西緯度、境界ボックスの経度座標 (コンマ区切り浮動小数点数)

Entity

境界ボックスのエンティティ型ソース。 逆ジオコーディングの場合、これは常に位置と等しくなります。

名前 説明
position

string

位置エンティティ

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前 説明
info

object

追加情報。

type

string

追加情報の種類。

ErrorDetail

エラーの詳細。

名前 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

ErrorDetail[]

エラーの詳細です。

message

string

エラー メッセージ。

target

string

エラーのターゲット。

ErrorResponse

エラー応答

名前 説明
error

ErrorDetail

error オブジェクト。

LatLongPairAbbreviated

短い名前 'lat' & 'lon' を使用して緯度と経度として表される場所。

名前 説明
lat

number

Latitude プロパティ

lon

number

Longitude プロパティ

LocalizedMapView

View パラメーター ("user region" パラメーターとも呼ばれます) を使用すると、地政学的に紛争が発生している地域の特定の国/地域の正しいマップを表示できます。 このようなリージョンのビューは国や地域によって異なり、View パラメーターを使用すると、アプリケーションが提供する国/地域に必要なビューにアプリケーションを準拠できます。 既定では、要求で定義していない場合でも、View パラメーターは "Unified" に設定されます。 ユーザーの場所を特定し、その場所を正しく View パラメーターを設定するのはユーザーの責任です。 または、要求の IP アドレスに基づいてマップ データを返す 'View = Auto' を設定することもできます。 Azure Mapsの View パラメーターは、マップ、画像、その他のデータ、Azure Maps経由でアクセスする権限を持つ第三者のコンテンツが利用可能になる国/地域のマッピングに関する法律を含む、適用される法律に準拠して使用する必要があります。 例: view=IN。

詳細については、「 サポートされているビュー 」を参照し、使用可能なビューを参照してください。

名前 説明
AE

string

アラブ首長国連邦、AE

AR

string

アルゼンチン (アルゼンチン ビュー)

Auto

string

要求の IP アドレスに基づいてマップ データを返します。

BH

string

バーレーン (アラビアのビュー)

IN

string

インド (インド ビュー)

IQ

string

イラク (アラビアのビュー)

JO

string

ヨルダン (アラビアのビュー)

KW

string

クウェート (アラビアのビュー)

LB

string

レバノン (アラビアのビュー)

MA

string

モロッコ (モロッコのビュー)

OM

string

オマーン (アラビアのビュー)

PK

string

パキスタン (パキスタンのビュー)

PS

string

パレスチナ自治政府 (アラビアのビュー)

QA

string

カタール (アラビアのビュー)

SA

string

サウジアラビア (アラビアのビュー)

SY

string

シリア (アラビアのビュー)

Unified

string

統一されたビュー (その他)

YE

string

イエメン (アラビアのビュー)

QueryType

返されるクエリの種類: NEARBY または NON_NEAR。

名前 説明
NEARBY

string

Searchは、定義された半径を持つ特定の緯度と経度を中心に実行されました

NON_NEAR

string

Searchは、特定の緯度と経度に偏らず、半径が定義されていない、グローバルに実行されました

ResponseFormat

応答の目的の形式。 値には json または xml を指定できます。

名前 説明
json

string

JavaScript オブジェクト表記データ交換形式

xml

string

拡張可能なマークアップ言語

ReverseSearchCrossStreetAddressResult

このオブジェクトは、アドレス逆引きクロスストリート呼び出しが成功したSearchから返されます

名前 説明
addresses

ReverseSearchCrossStreetAddressResultItem[]

アドレス配列

summary

SearchSummary

Search Address Reverse Cross Street 応答の Summary オブジェクト

ReverseSearchCrossStreetAddressResultItem

Search Address Reverse Cross Street 応答の Result オブジェクト

名前 説明
address

Address

結果のアドレス

position

string

"{latitude},{longitude}" の形式の Position プロパティ

SearchSummary

Search API 応答の Summary オブジェクト。

名前 説明
fuzzyLevel

integer

結果を提供するために必要な最大あいまいレベル。

geoBias

LatLongPairAbbreviated

内部検索エンジンが地理空間バイアスを適用して結果のランク付けが向上したことを示します。 一部のメソッドでは、利用可能な場合に lat パラメーターと lon パラメーターを設定すると、これが影響を受ける可能性があります。 それ以外の場合は、純粋に内部的です。

limit

integer

返される応答の最大数

numResults

integer

応答の結果の数。

offset

integer

完全な結果セット内で返される結果の開始オフセット。

query

string

これらの検索結果の生成に使用されたクエリ パラメーター。

queryTime

integer

クエリの解決に費やされた時間 (ミリ秒単位)。

queryType

QueryType

返されるクエリの種類: NEARBY または NON_NEAR。

totalResults

integer

検出された結果の合計数。