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

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

string

اختياريّ. البلدة الفرعية للعنوان
addressLines[]

string

سطور عناوين غير منظَّمة تصف المستويات الدنيا للعنوان

الطُرق

delete

 لحذف مبنى

get

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

insert

 لإدراج مبنى

list

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

patch

 تصحيحات في مبنى

update

 تعديلات على مبنى