Timezone - Get Timezone By Coordinates

指定した緯度と経度のペアの現在、履歴、および将来のタイムゾーン情報を取得するために使用します。
Get Timezone By Coordinates API は、指定した緯度と経度のペアの現在、履歴、および将来のタイム ゾーン情報を返す HTTP GET 要求です。 さらに、この API は、太陽の日を観察する地域を除き、特定の場所の日の入りと日の出の時間を提供します。

GET {endpoint}/timezone/byCoordinates/json?api-version=1.0&query={query}

GET {endpoint}/timezone/byCoordinates/json?api-version=1.0&options={options}&timeStamp={timeStamp}&transitionsFrom={transitionsFrom}&transitionsYears={transitionsYears}&query={query}

URI パラメーター

要求ヘッダー

応答

セキュリティ

AadToken

これらはMicrosoft Entra OAuth 2.0フローです。 Azureロールベースアクセス制御と組み合わせることで、Azure Maps REST APIへのアクセス制御に利用できます。 Azure ロールベースのアクセス制御は、1つ以上の Azure Maps リソースアカウントまたはサブリソースへのアクセスを指定するために使用されます。 任意のユーザー、グループ、またはサービスプリンシパルは、組み込みの役割や1つ以上のREST API権限からなるカスタムロールを通じてアクセス権Azure Maps付与されます。\n\nシナリオを実装するには、authentication conceptsを見ることをお勧めします。 まとめると、このセキュリティ定義は、特定のAPIやスコープでアクセス制御が可能なオブジェクトを通じてアプリケーションをモデリングするソリューションを提供します。\n\n#### 注記\n* このセキュリティ定義要求x-ms-client-idヘッダーを使用してアプリケーションがどのAzure Mapsリソースへのアクセスを要求しているかを示します。 これはMaps管理APIから取得可能です。\n* \nAuthorization URLはAzureパブリッククラウドインスタンス専用です。 ソブリンクラウドは固有の認可URLとMicrosoft Entra IDの設定を持っています。 \n* \nAzureロールベースのアクセス制御は、Azure管理プレーンから、Azureポータル、PowerShell、CLI、Azure SDK、REST APIを通じて構成されます。\n* \nAzure MapsWeb SDKは、複数のユースケース向けにアプリケーションの設定を可能にします。\n* Microsoft ID プラットフォームの詳細については、Microsoft ID プラットフォーム概要をご覧ください。

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

スコープ

subscription-key

これは共有キーで、AzureポータルでCreate a Azure Maps accountを行うか、PowerShell、CLI、Azure SDK、REST APIを使ってプロビジョニングされます。\n\n このキーがあれば、どのアプリケーションでもすべてのREST APIにアクセスできます。 つまり、この鍵は発行された口座のマスターキーとして使うことができます。\n\n 公開されているアプリケーションについては、confidential client applications方式を用いてREST API Azure Mapsにアクセスし、鍵を安全に保存できるようにすることをお勧めします。

型: apiKey
/: header

SAS Token

これは共有アクセス署名トークンで、Azure MapsリソースのList SAS操作からAzureポータル、PowerShell、CLI、Azure SDK、REST APIを通じてAzure管理プレーンを経由して作成されます。\n\n このトークンにより、どのアプリケーションでもAzureでアクセスが許可されますロールベースのアクセス制御や、特定のトークンの有効期限、速度、使用領域の細かい制御。 言い換えれば、SASトークンは共有鍵よりも安全な方法でアクセスを制御するために使えます。\n\n 公開されているアプリケーションについては、 Mapアカウントリソース 上で許可された発信元の特定のリストを設定し、レンダリングの乱用を制限し、SASトークンを定期的に更新することを推奨します。

型: apiKey
/: header

例

Successfully retrieve timezone by coordinates

GET {endpoint}/timezone/byCoordinates/json?api-version=1.0&options=all&query=47,-122

{
  "referenceUtcTimestamp": "2019-06-17T22:16:59.0765556Z",
  "timeZones": [
    {
      "aliases": [
        "US/Pacific",
        "US/Pacific-New"
      ],
      "countries": [
        {
          "code": "US",
          "name": "United States"
        }
      ],
      "id": "America/Los_Angeles",
      "names": {
        "daylight": "Pacific Daylight Time",
        "generic": "Pacific Time",
        "iso6391LanguageCode": "en",
        "standard": "Pacific Standard Time"
      },
      "referenceTime": {
        "daylightSavings": "01:00:00",
        "posixTz": "PST+8PDT,M3.2.0,M11.1.0",
        "posixTzValidYear": 2019,
        "standardOffset": "-08:00:00",
        "sunrise": "2019-06-17T05:12:21.267-07:00",
        "sunset": "2019-06-17T21:05:18.017-07:00",
        "tag": "PDT",
        "wallTime": "2019-06-17T15:16:59.0765556-07:00"
      },
      "representativePoint": {
        "latitude": 34.05222222222222,
        "longitude": -118.24277777777777
      },
      "timeTransitions": [
        {
          "daylightSavings": "01:00:00",
          "standardOffset": "-08:00:00",
          "tag": "PDT",
          "utcEnd": "2019-11-03T09:00:00Z",
          "utcStart": "2019-03-10T10:00:00Z"
        },
        {
          "daylightSavings": "00:00:00",
          "standardOffset": "-08:00:00",
          "tag": "PST",
          "utcEnd": "2020-03-08T10:00:00Z",
          "utcStart": "2019-11-03T09:00:00Z"
        },
        {
          "daylightSavings": "01:00:00",
          "standardOffset": "-08:00:00",
          "tag": "PDT",
          "utcEnd": "2020-11-01T09:00:00Z",
          "utcStart": "2020-03-08T10:00:00Z"
        }
      ]
    }
  ],
  "version": "2019a"
}

定義

CountryRecord

国/地域レコード。

ErrorAdditionalInfo

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

ErrorDetail

エラーの詳細。

ErrorResponse

すべてのAzure Resource Manager APIで失敗した操作に対してエラー詳細を返す共通のエラー応答です。 (これは、OData エラー応答形式にも従います)。

JsonFormat

応答の目的の形式。 json 形式のみがサポートされています。

ReferenceTime

現地時刻に有効な詳細。

RepresentativePoint

代表的なポイント プロパティ

TimeTransition

タイムゾーンの移行を表しています。

TimezoneId

タイムゾーンID情報。

TimezoneNames

タイムゾーン名オブジェクト。

TimezoneOptions

結果にはタイムゾーン情報のオプションが表示されました。

TimezoneResult

このオブジェクトは、成功したタイムゾーンの ID 呼び出しまたは座標による呼び出しから返されます