REST Resource: resources.buildings

المرجع: المبنى

واجهة برمجة التطبيقات العامة: 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

واجهة برمجة التطبيقات العامة: Resources.buildings

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

number

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

longitude

number

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

BuildingAddress

واجهة برمجة التطبيقات العامة: Resources.buildings

تمثيل 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

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