Package google.type

الفهرس

LatLng

عنصر يمثّل زوجًا من خطوط العرض/خطوط الطول ويتم التعبير عن ذلك كزوج من الأعداد المزدوجة لتمثيل درجات خط العرض ودرجات خط الطول. يجب أن يكون هذا العنصر متوافقًا مع معيار WGS84 ما لم يتم تحديد خلاف ذلك. يجب أن تكون القيم ضمن النطاقات العادية.

الحقول
latitude

double

خط العرض بالدرجات يجب أن يكون ضمن النطاق [-90.0, +90.0].
longitude

double

خط الطول بالدرجات. يجب أن يكون في النطاق [ -180.0، +180.0].

PostalAddress

يمثّل عنوانًا بريديًا، مثل عناوين التسليم البريدي أو عناوين الدفعات. استنادًا إلى عنوان بريدي، يمكن لخدمة بريدية تسليم السلع إلى مبنى أو صندوق بريد أو ما شابه. ولا يهدف إلى وضع نماذج للمواقع الجغرافية (الطرق والمدن والجبال).

في الاستخدام العادي، سيتم إنشاء عنوان من خلال إدخال المستخدم أو من خلال استيراد البيانات الحالية، وذلك حسب نوع العملية.

نصائح بشأن إدخال العنوان أو تعديله: - استخدام تطبيق مصغّر بعنوان جاهز للاستخدام مع مختلف البلدان، مثل https://github.com/google/libaddressinput). يجب عدم تقديم عناصر واجهة المستخدم إلى المستخدمين لإدخال أو تعديل الحقول خارج البلدان التي يُستخدَم فيها هذا الحقل.

لمزيد من الإرشادات حول كيفية استخدام هذا المخطّط، يُرجى الاطّلاع على: https://support.google.com/business/answer/6397478.

الحقول
revision

int32

تمثّل هذه السمة مراجعة المخطط لـ PostalAddress. أمّا القيمة الأخرى غير 0، فستعرض واجهة برمجة التطبيقات الخطأ INVALID_ARGUMENT.
region_code

string

اختياريّ. رمز منطقة CLDR للبلد أو المنطقة التي يقع فيها العنوان اطّلِع على https://cldr.unicode.org/ وhttps://www.unicode.org/cldr/charts/30/supplemental/territory_information.html للاطّلاع على التفاصيل. على سبيل المثال، "CH" لسويسرا. في حال عدم توفّر رمز المنطقة، سيتم استنتاجه من العنوان. للحصول على أفضل أداء، ننصحك بتضمين رمز المنطقة إذا كنت تعرفه. يمكن أن يؤدي استخدام مناطق غير متّسقة أو متكرّرة إلى ضعف الأداء. على سبيل المثال، إذا كان address_lines يتضمّن المنطقة، لا تقدِّم رمز المنطقة مرة أخرى في هذا الحقل. يمكنك الاطّلاع على المناطق التي تتوفّر فيها هذه الميزة في الأسئلة الشائعة.
language_code

string

إنّ رمز اللغة في عنوان الإدخال محجوز للاستخدامات المستقبلية ويتم تجاهله حاليًا. تعرض واجهة برمجة التطبيقات العنوان باللغة المناسبة للمكان الذي يقع فيه العنوان.
postal_code

string

اختياريّ. الرمز البريدي للعنوان لا تستخدم بعض البلدان الرموز البريدية أو تشترط توفّرها، ولكن في البلدان التي يتم استخدامها فيها، قد تؤدي إلى إجراء عمليات تحقّق إضافية مع أجزاء أخرى من العنوان (مثل التحقّق من الولاية/رمز المنطقة في الولايات المتحدة).
sorting_code

string

اختياريّ. رمز ترتيب إضافي خاص بكل بلد لا تُستخدم هذه الميزة في معظم المناطق. وفي حال استخدامها، تكون القيمة إما سلسلة مثل CEDEX، متبوعة اختياريًا برقم (مثل CEDEX 7)، أو رقمًا فقط يمثّل "رمز القطاع" (جامايكا) أو "مؤشر منطقة التسليم" (ملاوي) أو "مؤشر مكتب البريد" (مثل ساحل العاج).
administrative_area

string

اختياريّ. أعلى تقسيم فرعي إداري يتم استخدامه للعناوين البريدية لبلد أو منطقة. على سبيل المثال، يمكن أن تكون ولاية أو مقاطعة أو مقاطعة أو محافظة. في إسبانيا تحديدًا، يشير هذا الحقل إلى المقاطعة وليس إلى المنطقة الذاتية الحكم (مثل "برشلونة" وليس "كتالونيا"). لا تستخدم العديد من البلدان منطقة إدارية في العناوين البريدية. على سبيل المثال، في سويسرا، يجب عدم تعبئة هذا الحقل.
locality

string

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

string

اختياريّ. المنطقة المحلية الفرعية للعنوان. على سبيل المثال، يمكن أن تكون الأحياء أو المناطق الإدارية أو المناطق.
address_lines[]

string

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

بما أنّ القيم في address_lines لا تحتوي على معلومات عن النوع وقد تحتوي أحيانًا على قيم متعدّدة في حقل واحد (مثل "القاهرة، مصر")، من المهم أن يكون ترتيب الأسطر واضحًا. يجب أن يكون ترتيب سطور العنوان هو "ترتيب المظروف" للبلد أو المنطقة التي يقع فيها العنوان.

يتكون الحد الأدنى المسموح به للتمثيل الهيكلي للعنوان من جميع المعلومات المضمّنة في address_lines. إذا لم يتم تقديم region_code، يتم استنتاج المنطقة من أسطر العنوان.

إنّ إنشاء عنوان يحتوي فقط على address_lines، ثمّ ترميزه جغرافيًا هو الطريقة المُقترَحة للتعامل مع العناوين غير المنظَّمة تمامًا (بدلاً من تخمين أجزاء العنوان التي يجب أن تكون مناطق محلية أو مناطق إدارية).
recipients[]

string

يُرجى تجنُّب ضبط هذا الحقل. ولا تستخدِم واجهة برمجة التطبيقات Address Validation API هذا الإجراء حاليًا. على الرغم من أنّ واجهة برمجة التطبيقات لن ترفض في الوقت الحالي الطلبات التي تم ضبط هذا الحقل فيها، سيتم تجاهل المعلومات ولن يتم عرضها في الاستجابة.
organization

string

يُرجى تجنُّب ضبط هذا الحقل. ولا تستخدِم واجهة برمجة التطبيقات Address Validation API هذا الإجراء حاليًا. لن ترفض واجهة برمجة التطبيقات في الوقت الحالي الطلبات التي تتضمّن مجموعة الحقول هذه، إلا أنّه سيتم تجاهل المعلومات ولن يتم عرضها في الردّ.