Search - Get Reverse Geocoding

経度と緯度の座標から番地と位置情報を取得するために使用します。
Get Reverse Geocoding API は、座標 (例: 37.786505、-122.3862) を人間が理解できる住所に変換するために使用される HTTP GET リクエストです。 デバイスまたは資産からGPSフィードを受信し、座標に関連付けられたアドレスを知りたい追跡アプリケーションに役立ちます。 このエンドポイントは、特定の座標のアドレス情報を返します。

GET {endpoint}/reverseGeocode?api-version=2026-01-01&coordinates={coordinates}

GET {endpoint}/reverseGeocode?api-version=2026-01-01&coordinates={coordinates}&resultTypes={resultTypes}&view={view}

URI パラメーター

要求ヘッダー

応答

セキュリティ

AadToken

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

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

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

スコープ

subscription-key

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

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

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

型: apiKey
/: header

SAS Token

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

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

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

型: apiKey
/: header

例

Search point -122.138681, 47.630358

GET https://atlas.microsoft.com/reverseGeocode?api-version=2026-01-01&coordinates=-122.138681,47.630358

Content-Type: application/geo+json

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "address": {
          "countryRegion": {
            "name": "United States"
          },
          "adminDistricts": [
            {
              "name": "Washington",
              "shortName": "WA"
            },
            {
              "name": "King County",
              "shortName": "King Co."
            }
          ],
          "formattedAddress": "15127 NE 24th St, Redmond, Washington 98052",
          "streetName": "NE 24th St",
          "streetNumber": "15127",
          "locality": "Redmond",
          "postalCode": "98052",
          "addressLine": "15127 NE 24th St"
        },
        "type": "Address",
        "confidence": "Medium",
        "matchCodes": [
          "Good"
        ],
        "geocodePoints": [
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.138681,
                47.630358
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Display"
            ]
          },
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.1386787,
                47.6302179
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Route"
            ]
          }
        ]
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.138681,
          47.630358
        ]
      },
      "bbox": [
        -122.14632282407,
        47.626495282429325,
        -122.13103917593001,
        47.63422071757068
      ]
    }
  ]
}

定義

Address

ジオコードまたはオートコンプリートで提案された場所のアドレスを構造化されたフィールドに解析します。 疎外は正常であり、解決されたエンティティが供給するフィールドのみが埋め込まれます。 例えば、 streetName と streetNumber は道路レベルの住所にのみ現れ、 intersection は道路交差点の結果にのみ表示されます。

AddressAdminDistrictsItem

住所を含む行政区画です。 例えば、州、州、郡などです。 親 Address.adminDistricts 配列の1エントリとして返され、エントリは粗い順から細かい順に並んでいます。

AddressCountryRegion

住所を含む国または地域は、表示名およびISO 3166-1 Alpha-2国コードで識別されます。 回答ではどちらのフィールドも省略することができます。

Azure.Core.Foundations.Error

エラー オブジェクト。

Azure.Core.Foundations.ErrorResponse

エラーの詳細を含む応答。

Azure.Core.Foundations.InnerError

エラーに関するより具体的な情報を含むオブジェクト。 REST APIのガイドラインAzure https://aka.ms/AzureRestApiGuidelines#handling-errors。

CalculationMethodEnum

ジオコーディング ポイントの計算に使用されたメソッド。

ConfidenceEnum

ジオコーディングされた場所の結果が一致する信頼度。 この値をマッチコードと組み合わせて、試合に関するより完全な情報を取得しましょう。

ジオコードされた位置の信頼度は、指定された場合の位置の相対的重要性やユーザーの位置など、多くの要因に基づいています。

FeatureCollectionEnum

GeoJSONオブジェクトタイプは、順方向ジオコーディング、逆ジオコーディング、オートコンプリート操作(バッチ形式を含む)からの成功した応答のルートとして用いられます。 唯一の値はRFC 7946で定義された「FeatureCollection」です。 Get Polygon は唯一の例外であり、その応答根は GeoJSON Featureである。詳細は FeatureTypeEnumを参照。

FeaturesItem

GeocodingResponseのfeatures配列に単一のエントリがあり、GeoJSON Featureオブジェクトの形状に合致します。 1つのジオコーディング済みの位置を表します: properties上の構造化データ、 geometry上の代表座標、 bbox上のオプションの境界ボックス。

FeaturesItemProperties

機能の中 properties のペイロード GeocodingResponse。 ジオコードされた位置のエンティティタイプおよびマッチ品質指標、解析されたアドレスコンポーネント、そして位置を特定の座標にピン留めする1つ以上のジオコードポイントを搭載しています。

FeatureTypeEnum

FeatureオブジェクトのGeoJSONオブジェクトタイプ。 各エントリはFeatureCollection応答のfeatures配列内(ジオコーディング、逆ジオコーディング、オートコンプリート)にタグ付けされ、Get Polygon応答の根元に表示されます。 唯一の値はRFC 7946で定義された「Feature」です。

GeocodePointsItem

1つの位置を示すジオコードポイント:座標と、そのポイントがどのように計算されたか(calculationMethod)や最適な用途(usageTypes)を記述したメタデータです。 単一の特徴は通常、別々の Display 点と Route 点を返すため、発信者はタスクに合ったものを選択できます。

GeocodingResponse

成功した応答体は、 Get Geocoding と Get Reverse Geocodingで戻り、バッチごとの成功図は GeocodingBatchResponse.batchItems内に反映されました。 features配列にジオコードされた位置ごとに1つのFeatureを含むGeoJSON FeatureCollectionとしてエンコードされます。

GeoJsonObjectType

GeoJSON 型を指定します。 Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature、FeatureCollection の 9 つの有効な GeoJSON オブジェクト タイプのいずれかである必要があります。

GeoJsonPoint

有効な GeoJSON Point geometry 型。 詳細については、RFC 7946 を参照してください。

Intersection

道路交差点として解決された住所の交差点詳細 — 2つ以上の名前のある通りが交わる角。 解決されたエンティティが RoadIntersectionである場合にのみポップレーションされ、親 Address.intersection はそれ以外の場合は省略されます。

MatchCodesEnum

ジオコーディングサービスがどのように特定の位置結果を生み出したかを示すマッチコード値。 特徴の matchCodes フィールドはこれらの値の配列であり、それらを confidence や type と組み合わせてマッチの質を評価します。

ReverseGeocodingResultTypeEnum

Get Reverse Geocoding操作によって返されるエンティティタイプ。 resultTypesクエリパラメータに1つ以上の値として提供され、特定の種類の場所に限定されます。パラメータを省略すると、すべてのエンティティタイプが対象となります。 複数のタイプのエンティティが座標に一致する場合、最も具体的なもののみが返されます。 具体的な順にリストアップ: Address、 Neighborhood、 PopulatedPlace、 Postcode1、 AdminDivision1、 AdminDivision2、 CountryRegion。

UsageTypeEnum

ジオコードポイントの意図された用途。 サービスが返すジオコードポイントは、クライアントアプリケーションがそのポイントをどのように利用すべきかを示す1つ以上の使用タイプを持ちます。例えば、地図上に位置を表示するか、車両をそこへルーティングするかなどです。