REST Resource: resources.buildings

Tài nguyên: Toà nhà

API công khai: Resources.buildings

Biểu diễn dưới dạng JSON
{
  "buildingId": string,
  "buildingName": string,
  "description": string,
  "coordinates": {
    object (BuildingCoordinates)
  },
  "kind": string,
  "etags": string,
  "floorNames": [
    string
  ],
  "address": {
    object (BuildingAddress)
  }
}
Các trường
buildingId

string

Mã nhận dạng duy nhất của toà nhà. Độ dài tối đa là 100 ký tự.

buildingName

string

Tên toà nhà mà người dùng nhìn thấy trong Lịch. Phải riêng biệt đối với khách hàng. Ví dụ: "NYC-CHEL". Độ dài tối đa là 100 ký tự.

description

string

Mô tả ngắn về toà nhà. Ví dụ: "Chelsea Market".

coordinates

object (BuildingCoordinates)

Toạ độ địa lý của trung tâm toà nhà, được biểu thị bằng vĩ độ và kinh độ tính bằng độ thập phân.

kind

string

Đây là một loại tài nguyên.

etags

string

ETag của tài nguyên.

floorNames[]

string

Tên hiển thị của tất cả các tầng trong toà nhà này. Các giá sàn dự kiến sẽ được sắp xếp theo thứ tự tăng dần, từ giá sàn thấp nhất đến tầng cao nhất. Ví dụ: ["B2", "B1", "L", "1", "2", "2M", "3", "PH"] Phải chứa ít nhất một mục nhập.

address

object (BuildingAddress)

Địa chỉ bưu điện của toà nhà. Xem PostalAddress để biết thông tin chi tiết. Xin lưu ý rằng trường hợp chỉ yêu cầu một dòng địa chỉ và mã vùng.

BuildingCoordinates

API công khai: Resources.buildings

Biểu diễn dưới dạng JSON
{
  "latitude": number,
  "longitude": number
}
Các trường
latitude

number

Vĩ độ tính bằng độ thập phân.

longitude

number

Kinh độ theo độ thập phân.

BuildingAddress

API công khai: Resources.buildings

Biểu diễn dưới dạng JSON
{
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ]
}
Các trường
regionCode

string

Bắt buộc. Mã vùng CLDR của quốc gia/khu vực trên địa chỉ.

languageCode

string

Không bắt buộc. Mã ngôn ngữ BCP-47 của nội dung địa chỉ này (nếu biết).

postalCode

string

Không bắt buộc. Mã bưu chính của địa chỉ.

administrativeArea

string

Không bắt buộc. Phân khu hành chính cao nhất dùng cho địa chỉ bưu chính của một quốc gia hoặc khu vực.

locality

string

Không bắt buộc. Thường có nghĩa là phần thành phố/thị trấn trong địa chỉ. Ví dụ: Thành phố ở Hoa Kỳ, khu CNTT, thị trấn có bưu điện ở Vương quốc Anh. Ở những khu vực trên thế giới nơi các địa phương không được xác định rõ hoặc không phù hợp với cấu trúc này, hãy để trống địa phương và sử dụng addressLines.

sublocality

string

Không bắt buộc. Cụm dân cư của địa chỉ.

addressLines[]

string

Dòng địa chỉ không có cấu trúc mô tả các cấp thấp hơn của một địa chỉ.

Phương thức

delete

Xoá một toà nhà.

get

Truy xuất một toà nhà.

insert

Chèn một toà nhà.

list

Truy xuất danh sách toà nhà cho tài khoản.

patch

Vá một toà nhà.

update

Cập nhật một toà nhà.