Timezone - Get Timezone By Coordinates

Referencia

Service:: Maps

API Version:: 1.0

A használatával lekérheti a megadott szélességi és hosszúsági pár aktuális, előzmény- és jövőbeli időzóna-adatait.

Az Get Timezone By Coordinates API egy HTTP-kérés GET , amely egy adott szélességi és hosszúsági pár aktuális, előzmény- és jövőbeli időzónaadatait adja vissza. Emellett az API napnyugta- és napfelkelte-időpontokat is biztosít egy adott helyhez.

GET https://atlas.microsoft.com/timezone/byCoordinates/json?api-version=1.0&query={query}

With optional parameters:

GET https://atlas.microsoft.com/timezone/byCoordinates/json?api-version=1.0&options={options}&timeStamp={timeStamp}&transitionsFrom={transitionsFrom}&transitionsYears={transitionsYears}&query={query}

URI-paraméterek

Name	In	Kötelező	Típus	Description
format	path	True	JsonFormat	A válasz kívánt formátuma. Csak `json` a formátum támogatott.
api-version	query	True	string	Azure Maps API verziószáma.
query	query	True	number[]	Annak a pontnak a koordinátái, amelyre az időzóna-adatokat kérik. Ez a paraméter a koordináták listája, amely egy koordinátapárot (lat, long) tartalmaz. Ha ezt a végpontot közvetlenül hívják meg, a koordináták egyetlen, koordinátákat tartalmazó sztringként lesznek átadva, vesszővel elválasztva.
options	query		TimezoneOptions	Másik lehetőségként használja az "o" aliast. Az eredményben visszaadott információtípusokhoz elérhető beállítások.
timeStamp	query		string date-time	Másik lehetőségként használja a "stamp" vagy "s" aliast. Hivatkozási idő, ha nincs megadva, az API a kérést kiszolgáló gépi időt fogja használni.
transitionsFrom	query		string date-time	Másik lehetőségként használja a "tf" aliast. A nyári időszámítás (DST) áttűnésének kezdő dátuma csak akkor érvényes, ha "options" = all vagy "options" = transitions.
transitionsYears	query		integer	Másik lehetőségként használja a "ty" aliast. A DST-áttűnéseket igénylő "áttűnésekFrom" éveinek száma, csak akkor érvényes, ha "options" = all vagy "options" = transitions.

Kérelem fejléce

Name	Kötelező	Típus	Description
x-ms-client-id		string	Meghatározza, hogy melyik fiók legyen a Microsoft Entra ID biztonsági modellel együtt használva. Ez a Azure Maps fiók egyedi azonosítóját jelöli, és lekérhető a Azure Maps felügyeletisík Fiók API-jából. A Microsoft Entra ID biztonság Azure Maps az alábbi cikkekben talál útmutatást.
Accept-Language		string	Megadja azt a nyelvi kódot, amelyben az időzónák nevét vissza kell adni. Ha nincs megadva nyelvi kód, a válasz "EN" formátumban jelenik meg. Részletekért tekintse meg a támogatott nyelveket ismertető cikket.

Válaszok

Name	Típus	Description
200 OK	TimezoneResult	OK
Other Status Codes	ErrorResponse	Váratlan hiba történt.

Biztonság

AADToken

Ezek a Microsoft Entra OAuth 2.0-folyamatok. Az Azure-beli szerepköralapú hozzáférés-vezérléssel párosítva Azure Maps REST API-khoz való hozzáférés vezérlésére használható. Az Azure szerepköralapú hozzáférés-vezérlése egy vagy több Azure Maps erőforrásfiókhoz vagy alerőforráshoz való hozzáférés kijelölésére szolgál. Bármely felhasználó, csoport vagy szolgáltatásnév hozzáférést kaphat egy beépített szerepkörrel vagy egy vagy több rest API-Azure Maps ra vonatkozó engedélyből álló egyéni szerepkörrel.

A forgatókönyvek implementálásához javasoljuk, hogy tekintse meg a hitelesítési fogalmakat. Összefoglalva, ez a biztonsági definíció megoldást nyújt az alkalmazás(ok) adott API-k és hatókörök hozzáférés-vezérlésére képes objektumokon keresztüli modellezésére.

Jegyzetek

Ez a biztonsági definíció megköveteli a fejléc használatát annak x-ms-client-id jelzéséhez, hogy melyik Azure Maps erőforráshoz kér hozzáférést az alkalmazás. Ez a Maps management API-ból szerezhető be.

A Authorization URL az Azure nyilvános felhőpéldányára vonatkozik. A szuverén felhők egyedi engedélyezési URL-címekkel és Microsoft Entra ID konfigurációkkal rendelkeznek. * Az Azure szerepköralapú hozzáférés-vezérlése az Azure felügyeleti síkjáról van konfigurálva Azure Portal, PowerShell, CLI, Azure SDK-k vagy REST API-k használatával. * A Azure Maps Web SDK használata lehetővé teszi az alkalmazások konfigurációalapú beállítását több használati esetben.

A Microsoft Identitásplatform kapcsolatos további információkért lásd: Microsoft Identitásplatform áttekintése.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Ez egy megosztott kulcs, amely akkor lesz kiépítve, ha Létrehozás egy Azure Maps fiókot a Azure Portal vagy PowerShell, CLI, Azure SDK vagy REST API használatával.

Ezzel a kulccsal bármely alkalmazás hozzáférhet az összes REST API-hoz. Más szóval ez a kulcs használható főkulcsként abban a fiókban, amelyben ki vannak adva.

Nyilvánosan közzétett alkalmazások esetén javasoljuk, hogy a bizalmas ügyfélalkalmazások megközelítését használja Azure Maps REST API-k eléréséhez, hogy a kulcs biztonságosan tárolható legyen.

Type: apiKey
In: query

SAS Token

Ez egy közös hozzáférésű jogosultságkód-jogkivonat a listázási SAS műveletből jön létre az Azure Maps erőforráson keresztül az Azure felügyeleti síkján keresztül Azure Portal, PowerShell, CLI, Azure SDK-k vagy REST API-k használatával.

Ezzel a jogkivonattal minden alkalmazás jogosult hozzáférni az Azure szerepköralapú hozzáférés-vezérlőihez, valamint az adott jogkivonathoz használt lejárati időhöz, sebességhez és régióhoz. Más szóval az SAS-jogkivonattal az alkalmazások a megosztott kulcsnál biztonságosabb módon szabályozhatják a hozzáférést.

Nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy konfiguráljon egy adott listát az engedélyezett forrásokról a térképfiók-erőforráson a leképezési visszaélések korlátozásához és az SAS-jogkivonat rendszeres megújításához.

Type: apiKey
In: header

Példák

Successfully retrieve timezone by coordinates

Sample Request

HTTP

GET https://atlas.microsoft.com/timezone/byCoordinates/json?api-version=1.0&options=all&query=47,-122

Sample Response

Status code:: 200

{
  "Version": "2019a",
  "ReferenceUtcTimestamp": "2019-06-17T22:16:59.0765556Z",
  "TimeZones": [
    {
      "Id": "America/Los_Angeles",
      "Aliases": [
        "US/Pacific",
        "US/Pacific-New"
      ],
      "Countries": [
        {
          "Name": "United States",
          "Code": "US"
        }
      ],
      "Names": {
        "ISO6391LanguageCode": "en",
        "Generic": "Pacific Time",
        "Standard": "Pacific Standard Time",
        "Daylight": "Pacific Daylight Time"
      },
      "ReferenceTime": {
        "Tag": "PDT",
        "StandardOffset": "-08:00:00",
        "DaylightSavings": "01:00:00",
        "WallTime": "2019-06-17T15:16:59.0765556-07:00",
        "PosixTzValidYear": 2019,
        "PosixTz": "PST+8PDT,M3.2.0,M11.1.0",
        "Sunrise": "2019-06-17T05:12:21.267-07:00",
        "Sunset": "2019-06-17T21:05:18.017-07:00"
      },
      "RepresentativePoint": {
        "Latitude": 34.05222222222222,
        "Longitude": -118.24277777777777
      },
      "TimeTransitions": [
        {
          "Tag": "PDT",
          "StandardOffset": "-08:00:00",
          "DaylightSavings": "01:00:00",
          "UtcStart": "2019-03-10T10:00:00Z",
          "UtcEnd": "2019-11-03T09:00:00Z"
        },
        {
          "Tag": "PST",
          "StandardOffset": "-08:00:00",
          "DaylightSavings": "00:00:00",
          "UtcStart": "2019-11-03T09:00:00Z",
          "UtcEnd": "2020-03-08T10:00:00Z"
        },
        {
          "Tag": "PDT",
          "StandardOffset": "-08:00:00",
          "DaylightSavings": "01:00:00",
          "UtcStart": "2020-03-08T10:00:00Z",
          "UtcEnd": "2020-11-01T09:00:00Z"
        }
      ]
    }
  ]
}

Definíciók

Name	Description
CountryRecord	Egy ország-/régiórekord.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
JsonFormat	A válasz kívánt formátuma. Csak `json` a formátum támogatott.
ReferenceTime	A részletek helyi időpontban lépnek érvénybe.
RepresentativePoint	Reprezentatív pont tulajdonsága
TimeTransition
TimezoneId
TimezoneNames	Timezone names objektum.
TimezoneOptions	Másik lehetőségként használja az "o" aliast. Az eredményben visszaadott információtípusokhoz elérhető beállítások.
TimezoneResult	Ezt az objektumot egy sikeres Timezone Id hívás vagy koordináták szerinti hívás adja vissza

CountryRecord

Egy ország-/régiórekord.

Name	Típus	Description
Code	string	ISO-3166 kétbetűs ország-/régiókód az országhoz/régióhoz.
Name	string	ország/régió neve

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további adattípus.

ErrorDetail

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hiba célja.

ErrorResponse

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

JsonFormat

A válasz kívánt formátuma. Csak json a formátum támogatott.

Name	Típus	Description
json	string	A JavaScript object Notation Data Interchange formátuma

ReferenceTime

A részletek helyi időpontban lépnek érvénybe.

Name	Típus	Description
DaylightSavings	string	Az időmegtakarítás percek alatt érvénybe lép a következő időpontban: `ReferenceUTCTimestamp`.
PosixTz	string	AZ időzóna környezeti változójának beállításához használt POSIX-sztring.
PosixTzValidYear	integer	A POSIX-sztring érvényességi éve. Megjegyzés: A POSIX-sztring csak az adott évben érvényes.
StandardOffset	string	AZ UTC eltolása a következő időpontban lép érvénybe: `ReferenceUTCTimestamp`.
Sunrise	string	Napkelte az adott időzónában, ahogy az a `Tag` tulajdonságban látható. A napfelkeltét ISO8601 formátumban írják le. (Csak akkor tölthető fel, ha a hívás byCoordinates)
Sunset	string	Naplemente a megadott időzónában a `Tag` tulajdonságban látható módon. A naplemente leírása ISO8601 formátumban történik. (Csak akkor tölthető fel, ha a hívás byCoordinates)
Tag	string	Az időzóna neve a hivatkozási időbélyegben (azaz PST vagy PDT, attól függően, hogy a nyári időszámítás érvényes-e).
WallTime	string	Az aktuális fali idő az adott időzónában a tulajdonságban `Tag` látható módon.

RepresentativePoint

Reprezentatív pont tulajdonsága

Name	Típus	Description
Latitude	number	Latitude tulajdonság
Longitude	number	Hosszúság tulajdonság

TimeTransition

Name	Típus	Description
DaylightSavings	string	DaylightSavings tulajdonság
StandardOffset	string	StandardOffset tulajdonság
Tag	string	Címketulajdonság
UtcEnd	string	Az átmeneti időszak záró dátuma és befejezési időpontja
UtcStart	string	Az átmeneti időszak kezdő dátuma és kezdési időpontja

TimezoneId

Name	Típus	Description
Aliases	string[]	Időzóna-azonosító aliasok tömbje. Csak akkor adja vissza, ha [options]=zoneinfo vagy az összes. Megjegyzés: lehet, hogy null értékű.
Countries	CountryRecord[]	Ország-/régiórekordok tömbje. Csak akkor adja vissza, ha [options]=zoneinfo vagy az összes.
Id	string	Id tulajdonság
Names	TimezoneNames	Timezone names objektum.
ReferenceTime	ReferenceTime	A részletek helyi időpontban lépnek érvénybe.
RepresentativePoint	RepresentativePoint	Reprezentatív pont tulajdonsága
TimeTransitions	TimeTransition[]	Az időzóna DST-áttűnései [transitionsFrom] és időbélyeg + 1 év között.

TimezoneNames

Timezone names objektum.

Name	Típus	Description
Daylight	string	Nyári idő
Generic	string	Általános név
ISO6391LanguageCode	string	A Nevek ISO 639-1 nyelvi kódja
Standard	string	Standard név

TimezoneOptions

Másik lehetőségként használja az "o" aliast. Az eredményben visszaadott információtípusokhoz elérhető beállítások.

Name	Típus	Description
all	string	A zoneinfo és az áttűnések is belefoglalva az eredménybe.
none	string	Ne tartalmazzon zoneinfo vagy áttűnéseket az eredményben.
transitions	string	Adja meg az áttűnési adatokat az eredményben (Az áttűnések száma jelenleg 250-re van leképezve).
zoneInfo	string	Adjon meg további időzóna-adatokat az eredményben.

TimezoneResult

Ezt az objektumot egy sikeres Timezone Id hívás vagy koordináták szerinti hívás adja vissza

Name	Típus	Description
ReferenceUtcTimestamp	string	Hivatkozás utc időbélyeg tulajdonságra
TimeZones	TimezoneId[]	TimeZoneId tömb
Version	string	Verzió tulajdonság

Share via