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

 لتعديل مبنى