REST Resource: resources.buildings

المرجع: مبنى

واجهة برمجة التطبيقات العامة: مباني الموارد

تمثيل JSON 
{
  "buildingId": string,
  "buildingName": string,
  "description": string,
  "coordinates": {
    object (BuildingCoordinates)
  },
  "kind": string,
  "etags": string,
  "floorNames": [
    string
  ],
  "address": {
    object (BuildingAddress)
  }
}
الحقول
buildingId

string

معرّف فريد للمبنى الحد الأقصى للطول هو 100 حرف.
buildingName

string

اسم المبنى كما يراه المستخدمون في "تقويم Google" يجب أن يكون فريدًا للعميل. على سبيل المثال، "NYC-CHEL". الحد الأقصى للطول هو 100 حرف.
description

string

وصف موجز للمبنى. على سبيل المثال، "سوق دبي".
coordinates

object (BuildingCoordinates)

الإحداثيات الجغرافية لوسط المبنى، ويتم التعبير عنها بخط العرض وخط الطول بالدرجات العشرية.
kind

string

هذا نوع من الموارد.
etags

string

علامة ETag للمورد.
floorNames[]

string

الأسماء المعروضة لجميع الطوابق في هذا المبنى. من المتوقع فرز الطوابق بترتيب تصاعدي، من الطابق الأدنى إلى الطابق الأعلى. على سبيل المثال، يجب أن يحتوي ["B2" و"B1" و"L" و"1" و"2" و"2M" و"3" و"PH"] على إدخال واحد على الأقل.
address

object (BuildingAddress)

تمثّل هذه السمة العنوان البريدي للمبنى. ولمزيد من التفاصيل، يمكنك الاطّلاع على PostalAddress. تجدر الإشارة إلى الحاجة إلى سطر عنوان واحد ورمز منطقة واحد فقط.

BuildingCoordinates

واجهة برمجة التطبيقات العامة: مباني الموارد

تمثيل JSON 
{
  "latitude": number,
  "longitude": number
}
الحقول
latitude

number

خط العرض بالدرجات العشرية.
longitude

number

خط الطول بالدرجات العشرية.

BuildingAddress

واجهة برمجة التطبيقات العامة: مباني الموارد

تمثيل JSON 
{
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ]
}
الحقول
regionCode

string

مطلوب. رمز CLDR للبلد أو المنطقة التي يقع فيها العنوان.
languageCode

string

اختياريّ. رمز لغة محتوى هذا العنوان BCP-47 (إذا كان معروفًا)
postalCode

string

اختياريّ. الرمز البريدي للعنوان.
administrativeArea

string

اختياريّ. أعلى تقسيم فرعي إداري يتم استخدامه للعناوين البريدية لبلد أو منطقة.
locality

string

اختياريّ. يشير بوجه عام إلى الجزء من المدينة/البلدة من العنوان. أمثلة: مدينة في الولايات المتحدة، بلدية تكنولوجيا المعلومات، بلدة بريد المملكة المتحدة. في مناطق العالم التي لم يتم فيها تحديد المناطق المحلية بشكل جيد أو لا تتناسب مع هذا الهيكل جيدًا، اترك المنطقة المحلية فارغة واستخدم addressLines.
sublocality

string

اختياريّ. المنطقة المحلية الفرعية للعنوان.
addressLines[]

string

أسطر عنوان غير منظمة تصف المستويات الأدنى من العنوان.

الطُرق

delete

 حذف مبنى.

get

 لاسترداد مبنى.

insert

 يتم إدراج مبنى.

list

 لاسترداد قائمة المباني لأحد الحسابات.

patch

 يعمل على تصحيح المبنى.

update

 يتم تعديل أحد المباني.