REST Resource: resources.buildings

Zasób: budynek

Publiczny interfejs API: Resources.buildings

Zapis JSON
{
  "buildingId": string,
  "buildingName": string,
  "description": string,
  "coordinates": {
    object (BuildingCoordinates)
  },
  "kind": string,
  "etags": string,
  "floorNames": [
    string
  ],
  "address": {
    object (BuildingAddress)
  }
}
Pola
buildingId

string

Unikalny identyfikator budynku. Maksymalna długość to 100 znaków.

buildingName

string

Nazwa budynku widoczna dla użytkowników w Kalendarzu. Musi być niepowtarzalny dla każdego klienta. Przykład: „NYC-CHEL”. Maksymalna długość to 100 znaków.

description

string

Krótki opis budynku. Przykład: „Rynek Główny”.

coordinates

object (BuildingCoordinates)

Współrzędne geograficzne środka budynku wyrażone jako szerokość i długość geograficzną w stopniach dziesiętnych.

kind

string

To jest rodzaj tego zasobu.

etags

string

Tag ETag zasobu.

floorNames[]

string

Wyświetlane nazwy wszystkich pięter w tym budynku. Piętra powinny być posortowane w kolejności rosnącej, od najniższego do najwyższego. Na przykład ["B2", "B1", "L", "1", "2", "2M", "3", "PH"] Musi zawierać co najmniej 1 wpis.

address

object (BuildingAddress)

Adres pocztowy budynku. Więcej informacji: PostalAddress. Wymagany jest tylko jeden wiersz adresu i jeden kod regionu.

BuildingCoordinates

Publiczny interfejs API: Resources.buildings

Zapis JSON
{
  "latitude": number,
  "longitude": number
}
Pola
latitude

number

Szerokość geograficzna w stopniach dziesiętnych.

longitude

number

Długość geograficzna w stopniach dziesiętnych.

BuildingAddress

Publiczny interfejs API: Resources.buildings

Zapis JSON
{
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ]
}
Pola
regionCode

string

Wymagane. Kod regionu CLDR kraju lub regionu adresu.

languageCode

string

Opcjonalnie: Kod języka BCP-47 treści adresu (jeśli jest znany).

postalCode

string

Opcjonalnie: Kod pocztowy adresu.

administrativeArea

string

Opcjonalnie: Najwyższy podział administracyjny stosowany w przypadku adresów pocztowych kraju lub regionu.

locality

string

Opcjonalnie: Zasadniczo odnosi się do części miejscowości lub miejscowości. Przykłady: USA, gmina IT, poczta polska. W regionach, w których miejscowości nie są dobrze zdefiniowane lub nie pasują do tej struktury, zostaw pole Rejon puste, a następnie użyj addressLines.

sublocality

string

Opcjonalnie: Okręg, w którym znajduje się adres.

addressLines[]

string

Nieuporządkowane wiersze adresu opisujące dolne poziomy adresu.

Metody

delete

Usuwa budynek.

get

Pobiera budynek.

insert

Wstawia budynek.

list

Pobiera listę budynków powiązanych z kontem.

patch

Poprawia budynek.

update

Aktualizuje budynek.