Package google.maps.places.v1

الفهرس

الأماكن

تعريف خدمة Places API ملاحظة: كل طلب (باستثناء طلبات الإكمال التلقائي) يتطلب ضبط قناع حقل خارج نموذج الطلب (لا يتم افتراض السمة all/*). يمكن ضبط قناع الحقل من خلال عنوان HTTP X-Goog-FieldMask. لمزيد من المعلومات، يُرجى الانتقال إلى: https://developers.google.com/maps/documentation/places/web-service/choose-fields

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

تعرض توقعات للمدخل المحدد.
GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

احصل على وسائط صور مع سلسلة مرجعية للصور.
GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

يمكنك الحصول على تفاصيل المكان استنادًا إلى اسم مورده، وهو سلسلة بتنسيق places/{place_id}.
SearchNearby

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

البحث عن أماكن بالقرب من المواقع الجغرافية
SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

البحث عن الأماكن استنادًا إلى طلبات البحث النصية

AuthorAttribution

معلومات حول مؤلف بيانات المحتوى الذي ينشئه المستخدمون مُستخدَمة في Photo وReview.

الحقول
display_name

string

اسم مؤلف السمة Photo أو Review
uri

string

معرّف الموارد المنتظم (URI) لمؤلف Photo أو Review
photo_uri

string

معرّف الموارد المنتظم (URI) لصورة الملف الشخصي لمؤلف Photo أو Review.

AutocompletePlacesRequest

طلب نموذج أوّلي لـ AutocompletePlaces.

الحقول
input

string

مطلوبة. السلسلة النصية المطلوب البحث عليها.
location_bias

LocationBias

اختياريّ. تحيز النتائج إلى موقع محدد.

يجب ضبط سمة واحدة على الأكثر من location_bias أو location_restriction. وإذا لم يتم تحديد أي منهما، سيتم انحياز النتائج حسب عنوان IP، ما يعني تحديد عنوان IP لموقع غير دقيق واستخدامه كإشارة انحياز.
location_restriction

LocationRestriction

اختياريّ. حصر النتائج في موقع جغرافي محدّد

يجب ضبط سمة واحدة على الأكثر من location_bias أو location_restriction. وإذا لم يتم تحديد أي منهما، سيتم انحياز النتائج حسب عنوان IP، ما يعني تحديد عنوان IP لموقع غير دقيق واستخدامه كإشارة انحياز.
included_primary_types[]

string

اختياريّ. تم تضمين نوع "المكان" الأساسي (على سبيل المثال، "مطعم" أو "محطة وقود") من https://developers.google.com/maps/documentation/places/web-service/place-types. يتم إرجاع المكان فقط إذا تم تضمين نوعه الأساسي في هذه القائمة. ويمكن تحديد ما يصل إلى 5 قيم. وإذا لم يتم تحديد أي أنواع، يتم عرض جميع أنواع الأماكن.
included_region_codes[]

string

اختياريّ. يمكنك تضمين النتائج في المناطق المحددة فقط، وهي عبارة عن رمز مناطق مؤلفة من حرفين من حرفين من CLDR كحد أقصى. ولن تؤدي المجموعة الفارغة إلى تقييد النتائج. إذا تم ضبط كل من location_restriction وincluded_region_codes، ستكون النتائج في منطقة التقاطع.
language_code

string

اختياريّ. اللغة التي سيتم عرض النتائج بها. يتم ضبط الإعدادات التلقائية على en-US. قد تكون النتائج بلغات مختلطة إذا كانت اللغة المستخدَمة في input مختلفة عن language_code أو إذا لم تتوفر ترجمة للمكان الذي تم إرجاعه من اللغة المحلية إلى language_code.
region_code

string

اختياريّ. رمز المنطقة، محدّد كرمز منطقة مؤلف من حرفين CLDR. ويؤثر ذلك في تنسيق العنوان وترتيب النتائج وقد يؤثر في النتائج التي يتم عرضها. ولا يؤدي ذلك إلى حصر النتائج بالمنطقة المحدّدة. لحصر النتائج بمنطقة معيّنة، استخدِم السمة region_code_restriction.
origin

LatLng

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

int32

اختياريّ. إزاحة أحرف يونيكود المستندة إلى صفر لـ input تشير إلى موضع المؤشر في input. قد يؤثر موضع المؤشر على التوقعات التي يتم عرضها.

إذا كانت الصفحة فارغة، سيتم ضبط طول input تلقائيًا.
include_query_predictions

bool

اختياريّ. إذا كانت الإجابة "صحيح"، سيشمل الردّ توقّعات البحث عن المكان وطلب البحث. وإلا لن تعرض الاستجابة إلا تنبؤات المكان.
session_token

string

اختياريّ. سلسلة تحدِّد جلسة إكمال تلقائي لأغراض الفوترة. يجب أن تكون السلسلة آمنة من سلسلة base64 لعنوان URL ولها 36 حرف ASCII كحد أقصى. وفي حال عدم تنفيذ ذلك، يتم عرض خطأ POINTS_Quick.

تبدأ الجلسة عندما يبدأ المستخدم في كتابة طلب بحث، وتنتهي عند اختيار مكان وإجراء مكالمة إلى "تفاصيل المكان" أو "التحقّق من صحة العنوان". ويمكن أن تحتوي كل جلسة على طلبات بحث متعددة، متبوعة بطلب واحد من أجل التحقّق من صحة تفاصيل المكان أو العنوان. يجب أن تنتمي بيانات الاعتماد المستخدَمة لكل طلب خلال جلسة إلى المشروع نفسه على Google Cloud Console. بعد انتهاء الجلسة، لن يصبح الرمز المميز صالحًا، لذا يجب أن ينشئ تطبيقك رمزًا مميزًا جديدًا لكل جلسة. إذا تم حذف مَعلمة session_token، أو إذا أعدت استخدام رمز مميّز للجلسة، يتم تحصيل الرسوم من الجلسة كما لو لم يتم تقديم رمز مميّز للجلسة (تتم فوترة كل طلب على حدة).

نوصي بالإرشادات التالية:

  • استخدِم الرموز المميّزة للجلسة لجميع طلبات الإكمال التلقائي لـ "الأماكن".
  • إنشاء رمز مميّز جديد لكل جلسة ويُنصَح باستخدام الإصدار 4 من المعرّف الفريد العالمي (UUID).
  • تأكد من أن بيانات الاعتماد المستخدمة لجميع طلبات الإكمال التلقائي للأماكن وتفاصيل المكان وطلبات التحقق من صحة العنوان ضمن جلسة تنتمي إلى المشروع نفسه في Cloud Console.
  • تأكد من تمرير رمز مميز فريد للجلسة لكل جلسة جديدة. وسيؤدي استخدام الرمز المميّز نفسه لأكثر من جلسة إلى تحصيل رسوم كل طلب على حدة.

LocationBias

المنطقة المراد البحث فيها. قد تكون النتائج منحازة حول المنطقة المحددة.

الحقول

حقل الاتحاد type

يمكن أن يكون الحقل "type" واحدًا فقط مما يلي:
rectangle

Viewport

إطار عرض يتم تحديده من خلال زاوية شمالية شرقية وأخرى جنوبية غربية.
circle

Circle

دائرة محددة بواسطة نقطة مركزية ونصف قطر.

LocationRestriction

المنطقة المراد البحث فيها. ستقتصر النتائج على المنطقة المحدّدة.

الحقول

حقل الاتحاد type

يمكن أن يكون الحقل "type" واحدًا فقط مما يلي:
rectangle

Viewport

إطار عرض يتم تحديده من خلال زاوية شمالية شرقية وأخرى جنوبية غربية.
circle

Circle

دائرة محددة بواسطة نقطة مركزية ونصف قطر.

AutocompletePlacesResponse

نموذج الرد الخاص بـ AutocompletePlaces.

الحقول
suggestions[]

Suggestion

تحتوي على قائمة بالاقتراحات، مرتبة بترتيب تنازلي حسب مدى الصلة بالموضوع.

الاقتراح

نتيجة لاقتراح إكمال تلقائي

الحقول

حقل الاتحاد kind

يمكن أن يكون الحقل "kind" واحدًا فقط مما يلي:
place_prediction

PlacePrediction

توقع لمكان.
query_prediction

QueryPrediction

توقع لطلب بحث.

FormattableText

نص يمثّل عبارة عن مكان أو تنبؤ بطلب بحث. يمكن استخدام النص كما هو أو بتنسيق.

الحقول
text

string

النص الذي يمكن استخدامه على النحو أو بالتنسيق matches.
matches[]

StringRange

قائمة بنطاقات السلاسل التي تحدد موضع مطابقة طلب الإدخال في text يمكن استخدام النطاقات لتنسيق أجزاء معيّنة من text. قد لا تكون السلاسل الفرعية مطابقات تامة للسمة input إذا تم تحديد المطابقة بالاستناد إلى معايير أخرى غير مطابقة السلسلة (مثل التصحيحات الإملائية أو عمليات التحويل الصوتي).

هذه القيم هي إزاحة أحرف يونيكود لـ text. يتم ضمان ترتيب النطاقات بزيادة قيم الإزاحة.

PlacePrediction

نتائج التوقّع لتوقّع إكمال تلقائي لمكان

الحقول
place

string

اسم المورد للمكان المقترَح. ويمكن استخدام هذا الاسم في واجهات برمجة التطبيقات الأخرى التي تقبل أسماء الأماكن.
place_id

string

المعرّف الفريد للمكان المقترَح. ويمكن استخدام هذا المعرّف في واجهات برمجة التطبيقات الأخرى التي تقبل أرقام تعريف الأماكن.
text

FormattableText

تحتوي على اسم يمكن لشخص عادي قراءته للنتيجة التي يتم عرضها. بالنسبة إلى نتائج المؤسسة، عادةً ما يكون ذلك هو اسم النشاط التجاري وعنوانه.

يُنصح باستخدام text للمطوّرين الذين يريدون عرض عنصر واحد لواجهة المستخدم. بالنسبة إلى المطوِّرين الذين يريدون عرض عنصرَي واجهة مستخدم منفصلَين ولكن مترابطَين، قد ننصحهم باستخدام السمة structured_format بدلاً من ذلك. وهما طريقتان مختلفتان لتمثيل التنبؤ بالأماكن. يجب ألّا يحاول المستخدمون تحليل structured_format إلى text أو العكس.

قد يكون هذا النص مختلفًا عن display_name الذي يعرضه GetPlace.

وقد تظهر بلغات مختلطة إذا كان الطلبان input وlanguage_code بلغات مختلفة أو إذا لم تتوفر ترجمة للمكان من اللغة المحلية إلى language_code.
structured_format

StructuredFormat

تحليل تنبؤي بالمكان إلى نص رئيسي يحتوي على اسم المكان ونص ثانوي يحتوي على عناصر إضافية مميزة (مثل مدينة أو منطقة).

يُنصَح باستخدام structured_format للمطوّرين الذين يريدون عرض عنصرَين منفصلَين في واجهة المستخدم ولكنهما مرتبطان. يمكن للمطوّرين الذين يريدون عرض عنصر واحد في واجهة المستخدم استخدام text بدلاً من ذلك. وهما طريقتان مختلفتان لتمثيل التنبؤ بالأماكن. يجب ألّا يحاول المستخدمون تحليل structured_format إلى text أو العكس.
types[]

string

قائمة بالأنواع التي تنطبق على هذا المكان من الجدول "أ" أو الجدول "ب" في https://developers.google.com/maps/documentation/places/web-service/place-types.

النوع هو تصنيف للمكان. تشترك الأماكن ذات الأنواع المشتركة في خصائص متشابهة.
distance_meters

int32

طول الموقع الجيوديسي بالمتر من origin إذا تم تحديد origin. قد لا تتم تعبئة هذا الحقل بتوقعات معيّنة، مثل المسارات.

QueryPrediction

نتائج التوقّع لتوقّع إكمال تلقائي لطلب البحث

الحقول
text

FormattableText

النص المتنبأ به. لا يمثل هذا النص مكانًا، بل استعلامًا نصيًا يمكن استخدامه في نقطة نهاية البحث (على سبيل المثال، "البحث النصي").

يُنصح باستخدام text للمطوّرين الذين يريدون عرض عنصر واحد لواجهة المستخدم. بالنسبة إلى المطوِّرين الذين يريدون عرض عنصرَي واجهة مستخدم منفصلَين ولكن مترابطَين، قد ننصحهم باستخدام السمة structured_format بدلاً من ذلك. هناك طريقتان مختلفتان لتمثيل توقع طلب بحث. يجب ألّا يحاول المستخدمون تحليل structured_format إلى text أو العكس.

قد يتم استخدام لغات مختلطة إذا كان الطلبان input وlanguage_code بلغات مختلفة أو إذا لم تتم ترجمة جزء من طلب البحث من اللغة المحلية إلى language_code.
structured_format

StructuredFormat

تحليل تنبؤ طلب البحث إلى نص رئيسي يتضمن طلب البحث والنص الثانوي الذي يحتوي على ميزات إضافية واضحة (مثل مدينة أو منطقة).

يُنصَح باستخدام structured_format للمطوّرين الذين يريدون عرض عنصرَين منفصلَين في واجهة المستخدم ولكنهما مرتبطان. يمكن للمطوّرين الذين يريدون عرض عنصر واحد في واجهة المستخدم استخدام text بدلاً من ذلك. هناك طريقتان مختلفتان لتمثيل توقع طلب بحث. يجب ألّا يحاول المستخدمون تحليل structured_format إلى text أو العكس.

StringRange

تحدد سلسلة فرعية ضمن نص معين.

الحقول
start_offset

int32

إزاحة صفرية لحرف Unicode الأول في السلسلة (شاملة).
end_offset

int32

إزاحة صفرية لآخر حرف Unicode (حصري).

StructuredFormat

يحتوي على تقسيم لمكان أو توقع طلب بحث إلى نص رئيسي ونص ثانوي.

بالنسبة إلى توقعات المكان، يحتوي النص الرئيسي على الاسم المحدد للمكان. بالنسبة إلى عبارات البحث المقترحة، يحتوي النص الرئيسي على طلب البحث.

يحتوي النص الثانوي على عناصر إضافية واضحة (مثل مدينة أو منطقة) لتحديد المكان أو تحسين طلب البحث بشكل أكبر.

الحقول
main_text

FormattableText

تمثل اسم المكان أو طلب البحث.
secondary_text

FormattableText

تمثّل عناصر إضافية واضحة (مثل مدينة أو منطقة) لتحديد المكان أو تحسين طلب البحث بشكل أكبر.

دائرة

دائرة بها خط الطول والعرض كمركز ونصف قطر.

الحقول
center

LatLng

مطلوبة. توسيط خط العرض وخط الطول.

يجب أن يكون نطاق خط العرض في نطاق [ -90.0, 90.0]. يجب أن يكون نطاق خط الطول في نطاق [-180.0، 180.0].
radius

double

مطلوبة. يتم قياس النطاق بالمتر. يجب أن يكون النطاق الجغرافي ضمن [0.0, 50000.0].

ContentBlock

يشير ذلك المصطلح إلى جزء من المحتوى يمكن عرضه بشكل فردي.

الحقول
topic

string

موضوع المحتوى، على سبيل المثال "نظرة عامة" أو "مطعم".
content

LocalizedText

المحتوى المرتبط بالموضوع
references

References

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل.

يشير هذا المصطلح إلى المراجِع ذات الصلة بالجزء هذا من المحتوى.

ContextualContent

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل.

المحتوى المرتبط بطلب البحث عن المكان

الحقول
reviews[]

Review

قائمة بالمراجعات حول هذا المكان باستثناء طلب البحث عن المكان
photos[]

Photo

معلومات (بما في ذلك المراجع) حول صور هذا المكان، بجانب طلب البحث عن المكان
justifications[]

Justification

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل.

مبرّرات المكان.

السبب

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل.

مبرّرات المكان. تجيب المبررات عن السؤال حول السبب الذي قد يجعل المكان مهمًا للمستخدم النهائي.

الحقول

حقل الاتحاد justification

يمكن أن يكون الحقل "justification" واحدًا فقط مما يلي:
review_justification

ReviewJustification

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل.
business_availability_attributes_justification

BusinessAvailabilityAttributesJustification

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل.

BusinessAvailabilityAttributesJustification

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل. مبرّرات BusinessAvailabilityAttributes. يوضح هذا بعض السمات في النشاط التجاري والتي قد تهم المستخدم النهائي.

الحقول
takeout

bool

إذا كان المكان يقدّم الطعام السفري
delivery

bool

توفّر خدمة توصيل الطلبات في مكان معيّن
dine_in

bool

إذا كان المكان يوفّر خدمة تناول الطعام داخل المطعم

ReviewJustification

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل.

مبرّرات مراجعة المستخدِم. يبرز هذا قسم مراجعة المستخدم الذي قد يهم المستخدم النهائي. على سبيل المثال، إذا كان طلب البحث هو "بيتزا حطب"، يُبرز تبرير المراجعة النص ذي الصلة بطلب البحث.

الحقول
highlighted_text

HighlightedText
review

Review

المراجعة التي تم إنشاء النص المميّز منها.

HighlightedText

تمثّل هذه السمة النص الذي تم تمييزه من خلال التبرير. هذه مجموعة فرعية من المراجعة نفسها. يتم تمييز الكلمة نفسها التي يجب تمييزها باستخدام MarkedTextRange. قد يكون هناك عدة كلمات في النص الذي يتم تمييزه.

الحقول
text

string
highlighted_text_ranges[]

HighlightedTextRange

تمثّل هذه السمة نطاقات النص المميّز.

HighlightedTextRange

نطاق النص المميّز.

الحقول
start_index

int32
end_index

int32

EVChargeOptions

معلومات عن محطة شحن المركبة الكهربائية التي تستضيفها في Place. تتم إضافة المصطلحات التالية إلى https://afdc.energy.gov/fuels/electricity_infrastructure.html يمكن لمنفذ واحد شحن سيارة واحدة في كل مرة. يتضمن منفذ واحد موصل واحد أو أكثر. تتضمن محطة واحدة منفذًا واحدًا أو أكثر.

الحقول
connector_count

int32

عدد الموصلات في هذه المحطة ومع ذلك، نظرًا لأن بعض المنافذ يمكن أن تحتوي على موصلات متعددة، إلا أنها لا يمكنها شحن سيارة واحدة فقط في كل مرة (على سبيل المثال)، قد يكون عدد الموصلات أكبر من إجمالي عدد السيارات التي يمكن شحنها في آنٍ واحد.
connector_aggregation[]

ConnectorAggregation

قائمة بتجميعات موصلات شحن المركبات الكهربائية التي تحتوي على موصلات من النوع نفسه ومعدّل الشحن نفسه

ConnectorAggregation

يتم تجميع معلومات شحن المركبة الكهربائية حسب [type, max_charge_rate_kw]. تعرِض هذه السمة تجميع شحنة المركبات الكهربائية للموصّلات التي لها النوع نفسه ومعدّل الشحن الأقصى بالكيلوواط.

الحقول
type

EVConnectorType

نوع الموصِّل لهذه التجميع.
max_charge_rate_kw

double

الحد الأقصى لمعدل الشحن الثابت بالكيلوواط لكل موصِّل في التجميع.
count

int32

عدد الموصلات في هذه المجموعة.
availability_last_update_time

Timestamp

الطابع الزمني لآخر مرة تم فيها تعديل معلومات مدى توفُّر الموصل في هذا التجميع.
available_count

int32

عدد الموصلات المتوفرة حاليًا في هذه المجموعة.
out_of_service_count

int32

عدد الموصلات في هذه التجميع خارج الخدمة حاليًا.

EVConnectorType

يمكنك الانتقال إلى http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 للحصول على معلومات أو سياق إضافي حول أنواع موصِّلات شحن المركبات الكهربائية.

عمليات التعداد
EV_CONNECTOR_TYPE_UNSPECIFIED موصل غير محدد.
EV_CONNECTOR_TYPE_OTHER أنواع الموصِّلات الأخرى.
EV_CONNECTOR_TYPE_J1772 موصِّل J1772 من النوع 1.
EV_CONNECTOR_TYPE_TYPE_2 موصِّل IEC 62196 من النوع 2 يُشار إليها غالبًا باسم MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO موصل من نوع CHAdeMO
EV_CONNECTOR_TYPE_CCS_COMBO_1 نظام شحن مشترك (AC وDC). استنادًا إلى شركة SAE. وصلة من النوع 1 J-1772
EV_CONNECTOR_TYPE_CCS_COMBO_2 نظام شحن مشترك (AC وDC). استنادًا إلى موصل "مينيكس" من النوع 2
EV_CONNECTOR_TYPE_TESLA موصل TESLA العام وهي شركة NACS في أمريكا الشمالية، ولكن يمكن أن تكون بخلاف NACS في أجزاء أخرى من العالم (على سبيل المثال، CCS Combo 2 (CCS2) أو GB/T). هذه القيمة أقل تمثيلاً لنوع الموصل الفعلي، وتمثّل بشكل أكبر القدرة على شحن مركبة تحمل العلامة التجارية Tesla في محطة شحن مملوكة لشركة Tesla.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T يتوافق نوع GB/T مع معيار GB/T في الصين. يشمل هذا النوع جميع أنواع GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET مقبس حائط غير محدَّد

FuelOptions

أحدث المعلومات عن خيارات الوقود في محطة وقود. يتم تعديل هذه المعلومات بانتظام.

الحقول
fuel_prices[]

FuelPrice

آخر سعر للوقود معروف لكل نوع من أنواع الوقود في هذه المحطة. يتوفّر إدخال واحد لكلّ نوع وقود تتوفّر في هذه المحطة. الطلب ليس مهمًا.

FuelPrice

معلومات عن أسعار الوقود لنوع معيّن.

الحقول
type

FuelType

نوع الوقود
price

Money

سعر الوقود.
update_time

Timestamp

تاريخ آخر تعديل لسعر الوقود

FuelType

أنواع الوقود.

عمليات التعداد
FUEL_TYPE_UNSPECIFIED نوع الوقود غير محدَّد.
DIESEL وقود الديزل:
REGULAR_UNLEADED بانتظام بدون قائد.
MIDGRADE متوسط.
PREMIUM Premium
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 SP 100.
LPG غاز البترول المُسال.
E80 E 80.
E85 E 85.
METHANE الميثان
BIO_DIESEL الديزل الحيوي:
TRUCK_DIESEL شاحنة تعمل بالديزل.

GetPhotoMediaRequest

طلب جلب صورة لمكان باستخدام اسم مورد صور.

الحقول
name

string

مطلوبة. اسم المورد لوسائط الصور بالتنسيق: places/{place_id}/photos/{photo_reference}/media.

يأتي اسم المورد لصورة، كما يتم عرضه في حقل photos.name لعنصر المكان، بالتنسيق places/{place_id}/photos/{photo_reference}. يجب إلحاق /media بنهاية مورد الصور للحصول على اسم مورد وسائط الصور.
max_width_px

int32

اختياريّ. تُحدِّد الحد الأقصى لعرض الصورة بالبكسل. إذا كانت الصورة أصغر من القيم المحددة، سيتم عرض الصورة الأصلية. وإذا كانت الصورة أكبر في أي من البُعدَين، سيتم تغيير حجمها لكي تتطابق مع الحجم الأصغر بين البُعدَين، مع قصر على نسبة العرض إلى الارتفاع الأصلية. تقبل كل من الخاصيتين max_height_px وmax_width_px عددًا صحيحًا بين 1 و4800، بشكل شامل. إذا لم تكن القيمة ضمن النطاق المسموح به، سيتم عرض خطأ POINTS_{9}.

يجب تحديد قيمة واحدة على الأقل من max_height_px أو max_width_px. في حال عدم تحديد max_height_px أو max_width_px، سيتمّ عرض خطأ النقاط FI_Q.
max_height_px

int32

اختياريّ. تُحدِّد الحد الأقصى لارتفاع الصورة بالبكسل. إذا كانت الصورة أصغر من القيم المحددة، سيتم عرض الصورة الأصلية. وإذا كانت الصورة أكبر في أي من البُعدَين، سيتم تغيير حجمها لكي تتطابق مع الحجم الأصغر بين البُعدَين، مع قصر على نسبة العرض إلى الارتفاع الأصلية. تقبل كل من الخاصيتين max_height_px وmax_width_px عددًا صحيحًا بين 1 و4800، بشكل شامل. إذا لم تكن القيمة ضمن النطاق المسموح به، سيتم عرض خطأ POINTS_{9}.

يجب تحديد قيمة واحدة على الأقل من max_height_px أو max_width_px. في حال عدم تحديد max_height_px أو max_width_px، سيتمّ عرض خطأ النقاط FI_Q.
skip_http_redirect

bool

اختياريّ. في حال ضبطها، يمكنك تخطّي سلوك إعادة توجيه HTTP التلقائي وعرض استجابة بتنسيق نصّي (على سبيل المثال، بتنسيق JSON لحالة استخدام HTTP). وفي حال عدم ضبطها، سيتم إصدار إعادة توجيه HTTP لإعادة توجيه المكالمة إلى وسائط الصورة. ويتم تجاهل هذا الخيار للطلبات التي لا تستخدم HTTP.

GetPlaceRequest

طلب جلب مكان استنادًا إلى اسم مورده، وهو سلسلة بتنسيق places/{place_id}.

الحقول
name

string

مطلوبة. تمثّل هذه السمة اسم المورد لمكان، بالتنسيق places/{place_id}.
language_code

string

اختياريّ. سيتم عرض تفاصيل المكان باللغة المفضّلة إن توفّرت.

القائمة الحالية باللغات المعتمدة: https://developers.google.com/maps/faq#languagesupport.
region_code

string

اختياريّ. رمز البلد/المنطقة يونيكود (CLDR) للموقع الجغرافي الذي يأتي منه الطلب تُستخدَم هذه المَعلمة لعرض تفاصيل المكان، مثل اسم المكان الخاص بمنطقة معيّنة، إذا كان متاحًا. يمكن أن تؤثر المَعلمة في النتائج استنادًا إلى القانون الساري. لمزيد من المعلومات، يُرجى الاطّلاع على https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

تجدر الإشارة إلى أنّه لا يمكن حاليًا استخدام رموز المناطق المكوَّنة من 3 أرقام.
session_token

string

اختياريّ. سلسلة تحدِّد جلسة إكمال تلقائي لأغراض الفوترة. يجب أن تكون السلسلة آمنة من سلسلة base64 لعنوان URL ولها 36 حرف ASCII كحد أقصى. وفي حال عدم تنفيذ ذلك، يتم عرض خطأ POINTS_Quick.

تبدأ الجلسة عندما يبدأ المستخدم في كتابة طلب بحث، وتنتهي عند اختيار مكان وإجراء مكالمة إلى "تفاصيل المكان" أو "التحقّق من صحة العنوان". ويمكن أن تحتوي كل جلسة على طلبات بحث متعددة، متبوعة بطلب واحد من أجل التحقّق من صحة تفاصيل المكان أو العنوان. يجب أن تنتمي بيانات الاعتماد المستخدَمة لكل طلب خلال جلسة إلى المشروع نفسه على Google Cloud Console. بعد انتهاء الجلسة، لن يصبح الرمز المميز صالحًا، لذا يجب أن ينشئ تطبيقك رمزًا مميزًا جديدًا لكل جلسة. إذا تم حذف مَعلمة session_token، أو إذا أعدت استخدام رمز مميّز للجلسة، يتم تحصيل الرسوم من الجلسة كما لو لم يتم تقديم رمز مميّز للجلسة (تتم فوترة كل طلب على حدة).

نوصي بالإرشادات التالية:

  • استخدِم الرموز المميّزة للجلسة لجميع طلبات الإكمال التلقائي لـ "الأماكن".
  • إنشاء رمز مميّز جديد لكل جلسة ويُنصَح باستخدام الإصدار 4 من المعرّف الفريد العالمي (UUID).
  • تأكد من أن بيانات الاعتماد المستخدمة لجميع طلبات الإكمال التلقائي للأماكن وتفاصيل المكان وطلبات التحقق من صحة العنوان ضمن جلسة تنتمي إلى المشروع نفسه في Cloud Console.
  • تأكد من تمرير رمز مميز فريد للجلسة لكل جلسة جديدة. وسيؤدي استخدام الرمز المميّز نفسه لأكثر من جلسة إلى تحصيل رسوم كل طلب على حدة.

صورة

تمثّل هذه السمة معلومات حول صورة مكان.

الحقول
name

string

المُعرّف. مرجع يمثل صورة هذا المكان ويمكن استخدامه للبحث عن صورة هذا المكان مرة أخرى (يسمى أيضًا اسم "مورد" واجهة برمجة التطبيقات: places/{place_id}/photos/{photo}).
width_px

int32

الحد الأقصى للعرض المتاح بالبكسل.
height_px

int32

الحد الأقصى للارتفاع المتاح، بالبكسل.
author_attributions[]

AuthorAttribution

مؤلفو هذه الصورة.

PhotoMedia

وسائط صور من Places API

الحقول
name

string

اسم المورد لوسائط الصور بالتنسيق: places/{place_id}/photos/{photo_reference}/media.
photo_uri

string

معرّف موارد منتظم (URI) قصير العمر يمكن استخدامه لعرض الصورة

مكان

جميع المعلومات التي تمثل مكانًا معيّنًا.

الحقول
name

string

تمثّل هذه السمة اسم مورد هذا المكان، بالتنسيق places/{place_id}. يمكن استخدامها للبحث عن المكان.
id

string

المعرّف الفريد لمكان معيّن.
display_name

LocalizedText

الاسم المترجَم للمكان، والذي يناسب وصفًا قصيرًا يمكن للإنسان قراءته. على سبيل المثال، "Google الإسكندرية" أو "ستاربكس" أو "بيروت" وما إلى ذلك.
types[]

string

مجموعة من علامات النوع لهذه النتيجة. على سبيل المثال، "سياسي" و "المنطقة المحلية". للحصول على القائمة الكاملة للقيم المحتملة، يُرجى الاطّلاع على الجدول "أ" والجدول "ب" على الرابط https://developers.google.com/maps/documentation/places/web-service/place-types.
primary_type

string

النوع الأساسي للنتيجة المحددة. يجب أن يكون هذا النوع من الأنواع المتوافقة مع Places API. على سبيل المثال، "مطعم" أو "مقهى" أو "مطار" وما إلى ذلك. يمكن أن يكون للمكان نوع أساسي واحد فقط. للحصول على القائمة الكاملة للقيم المحتملة، يُرجى الاطّلاع على الجدول "أ" والجدول "ب" على الرابط https://developers.google.com/maps/documentation/places/web-service/place-types.
primary_type_display_name

LocalizedText

الاسم المعروض للنوع الأساسي، مترجمة إلى لغة الطلب، إذا كان ذلك منطبقًا. للحصول على القائمة الكاملة للقيم المحتملة، يُرجى الاطّلاع على الجدول "أ" والجدول "ب" على الرابط https://developers.google.com/maps/documentation/places/web-service/place-types.
national_phone_number

string

تمثّل هذه السمة رقم هاتف يمكن لشخص عادي قراءته، بالتنسيق الوطني.
international_phone_number

string

تمثّل هذه السمة رقم هاتف يمكن لشخص عادي قراءته بتنسيق دولي.
formatted_address

string

تمثّل هذه السمة عنوان كامل يمكن لشخص عادي قراءته.
short_formatted_address

string

تمثّل هذه السمة عنوان قصير يمكن للإنسان قراءته.
address_components[]

AddressComponent

مكوّنات متكرّرة لكل مستوى من مستويات المنطقة المحلية. يُرجى مراعاة المعلومات التالية حول مصفوفة address_components[]: - قد تحتوي مصفوفة مكوّنات العنوان على مكونات أكثر من format_address. - لا تتضمّن الصفيفة بالضرورة جميع الكيانات السياسية التي تحتوي على عنوان باستثناء الكيانات المتضمّنة في format_address. لاسترداد جميع الكيانات السياسية التي تحتوي على عنوان محدّد، عليك استخدام الترميز الجغرافي العكسي، مع تمرير خط العرض/خط الطول للعنوان كمَعلمة للطلب. - لا يمكن ضمان بقاء تنسيق الرد كما هو بين الطلبات. وعلى وجه الخصوص، يختلف عدد address_components بناءً على العنوان المطلوب ويمكن أن يتغير بمرور الوقت للعنوان نفسه. يمكن للمكون تغيير موضعه في الصفيفة. يمكن أن يتغير نوع المكون. قد يكون هناك مكوِّن غير متوفر في رد لاحق.
plus_code

PlusCode

رمز Plus Codes لخط العرض/الطول للموقع.
location

LatLng

تمثّل هذه السمة موضع هذا المكان.
viewport

Viewport

إطار عرض مناسب لعرض المكان على خريطة ذات حجم متوسط.
rating

double

تقييم بين 1.0 و5.0 استنادًا إلى مراجعات المستخدمين لهذا المكان
google_maps_uri

string

عنوان URL يقدّم المزيد من المعلومات عن هذا المكان
website_uri

string

تمثّل هذه السمة الموقع الإلكتروني الموثوق به لهذا المكان، مثل الصفحة الرئيسية لنشاط تجاري. تجدر الإشارة إلى أنّه بالنسبة إلى الأماكن التي تشكّل جزءًا من سلسلة متاجر (مثل متجر IKEA)، سيتمثل ذلك عادةً في الموقع الإلكتروني للمتجر الفردي، وليس السلسلة بأكملها.
reviews[]

Review

قائمة بالمراجعات حول هذا المكان، مرتبة حسب مدى صلتها بالموضوع يمكن إرجاع 5 مراجعات كحدّ أقصى.
regular_opening_hours

OpeningHours

ساعات العمل العادية:
photos[]

Photo

معلومات (بما في ذلك المراجع) عن صور هذا المكان يمكن عرض 10 صور كحدّ أقصى.
adr_format_address

string

عنوان المكان في تنسيق DKIM لـ adr: http://microformats.org/wiki/adr.
business_status

BusinessStatus

حالة النشاط التجاري للمكان.
price_level

PriceLevel

مستوى سعر المكان.
attributions[]

Attribution

مجموعة من مزوِّدي البيانات يجب أن يتم عرضها مع هذه النتيجة.
icon_mask_base_uri

string

عنوان URL مقتطَع إلى قناع رمز. يمكن للمستخدم الوصول إلى نوع رمز مختلف من خلال إلحاق نوع اللاحقة بالنهاية (على سبيل المثال، ".svg" أو ".png").
icon_background_color

string

لون الخلفية لـ icon_mask بالتنسيق السداسي العشري، مثل #909CE1.
current_opening_hours

OpeningHours

ساعات العمل خلال الأيام السبعة المقبلة (بما فيها اليوم). تبدأ الفترة الزمنية من منتصف الليل في تاريخ الطلب، وتنتهي عند الساعة 11:59 مساءً بعد ستة أيام. يتضمن هذا الحقل الحقل special_days لجميع الساعات، والذي يتم تعيينه للتواريخ التي تحتوي على ساعات استثنائية.
current_secondary_opening_hours[]

OpeningHours

يحتوي على مصفوفة من الإدخالات خلال الأيام السبعة المقبلة، بما في ذلك معلومات عن ساعات العمل الثانوية للنشاط التجاري. تختلف ساعات العمل الثانوية عن ساعات العمل الرئيسية للنشاط التجاري. على سبيل المثال، يمكن أن يحدد أحد المطاعم ساعات عمل السيارة أو ساعات التسليم كساعات ثانوية. يملأ هذا الحقل الحقل الفرعي للنوع، الذي يتم سحبه من قائمة محدّدة مسبقًا لأنواع ساعات العمل (مثل DRIVE_THROUGH أو PICKUP أو TakeOUT) استنادًا إلى أنواع المكان. يتضمن هذا الحقل الحقل special_days لجميع الساعات، والذي يتم تعيينه للتواريخ التي تحتوي على ساعات استثنائية.
regular_secondary_opening_hours[]

OpeningHours

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

LocalizedText

يحتوي على ملخّص للمكان. ويتكون الملخص من نظرة عامة نصية، ويتضمن أيضًا رمز اللغة لها إن أمكن. يجب تقديم نص الملخّص كما هو ولا يمكن تعديله أو تغييره.
payment_options

PaymentOptions

خيارات الدفع التي يقبلها المكان في حال عدم توفّر بيانات خيار الدفع، سيتم إلغاء ضبط حقل خيار الدفع.
parking_options

ParkingOptions

تتوفر خيارات لوقوف السيارات في المكان.
sub_destinations[]

SubDestination

قائمة بالوجهات الفرعية ذات الصلة بالمكان.
fuel_options

FuelOptions

أحدث المعلومات عن خيارات الوقود في محطة وقود. يتم تعديل هذه المعلومات بانتظام.
ev_charge_options

EVChargeOptions

معلومات حول خيارات شحن المركبات الكهربائية
generative_summary

GenerativeSummary

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل.

ملخّص للمكان من إنشاء الذكاء الاصطناعي
area_summary

AreaSummary

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل.

ملخّص من إنشاء الذكاء الاصطناعي للمنطقة التي يقع فيها المكان
utc_offset_minutes

int32

تتأثّر المنطقة الزمنية لهذا المكان حاليًا حسب التوقيت العالمي المنسَّق (UTC). يتم التعبير عن ذلك بالدقائق لدعم المناطق الزمنية التي يتم إزاحتها بكسور من الساعة، على سبيل المثال X ساعة و15 دقيقة.
user_rating_count

int32

إجمالي عدد المراجعات (التي تحتوي على نص أو بدونه) لهذا المكان
takeout

bool

تحدِّد هذه السياسة ما إذا كان النشاط التجاري يتيح طلب الوجبات لتناولها خارج المطعم.
delivery

bool

تحدّد هذه السمة ما إذا كان النشاط التجاري يتيح خدمة التسليم.
dine_in

bool

تحدّد هذه السمة ما إذا كان النشاط التجاري يوفّر خيارات المقاعد الداخلية أو الخارجية.
curbside_pickup

bool

تحدِّد هذه السياسة ما إذا كان النشاط التجاري يتيح استلام الطلبات من السيارة.
reservable

bool

لتحديد ما إذا كان المكان يتيح الحجوزات.
serves_breakfast

bool

تحدّد هذه السمة ما إذا كان المكان يقدّم وجبة الفطور.
serves_lunch

bool

تحدّد هذه السمة ما إذا كان المكان يقدّم وجبة الغداء.
serves_dinner

bool

تحدّد هذه السمة ما إذا كان المكان يقدّم وجبة العشاء.
serves_beer

bool

تحدّد هذه السمة ما إذا كان المكان يقدّم البيرة.
serves_wine

bool

تحدّد هذه السمة ما إذا كان المكان يقدّم النبيذ.
serves_brunch

bool

تحدّد هذه السمة ما إذا كان المكان يقدّم وجبات الفطور المتأخر.
serves_vegetarian_food

bool

تحدّد هذه السمة ما إذا كان المكان يقدّم مأكولات نباتية.
outdoor_seating

bool

يوفّر المكان أماكن جلوس في الهواء الطلق.
live_music

bool

يستضيف المكان عروضًا موسيقية حية.
menu_for_children

bool

يحتوي المكان على قائمة طعام للأطفال.
serves_cocktails

bool

يقدم المكان مشروبات الكوكتيل.
serves_dessert

bool

المكان يقدّم الحلويات.
serves_coffee

bool

المكان يقدّم القهوة.
good_for_children

bool

المكان مناسب للأطفال.
allows_dogs

bool

ويمكن اصطحاب الكلاب في هذا المكان.
restroom

bool

يحتوي المكان على مراحيض.
good_for_groups

bool

يتّسع المكان لمجموعات.
good_for_watching_sports

bool

المكان مناسب لمشاهدة الألعاب الرياضية.
accessibility_options

AccessibilityOptions

تمثّل هذه السمة معلومات حول خيارات تسهيل الاستخدام التي يقدّمها أحد الأماكن.

AccessibilityOptions

تمثّل هذه السمة معلومات حول خيارات تسهيل الاستخدام التي يقدّمها أحد الأماكن.

الحقول
wheelchair_accessible_parking

bool

يضم المكان موقفًا للسيارات مناسبًا للكراسي المتحركة.
wheelchair_accessible_entrance

bool

تشتمل الأماكن على مدخل صالح للكراسي المتحركة.
wheelchair_accessible_restroom

bool

يضمّ المكان دورة مياه صالحة للكراسي المتحركة.
wheelchair_accessible_seating

bool

يضم المكان أماكن جلوس صالحة للكراسي المتحركة.

AddressComponent

يشير ذلك المصطلح إلى المكوّنات المنظَّمة التي تشكِّل العنوان المنسَّق، إذا كانت هذه المعلومات متاحة.

الحقول
long_text

string

وصف النص الكامل أو اسم مكوّن العنوان على سبيل المثال، قد يحتوي عنصر العنوان للبلد الأسترالي على long_name "أستراليا".
short_text

string

اسم نصي مختصر لمكوّن العنوان، إذا كان متاحًا على سبيل المثال، قد يحتوي مكوّن العنوان لدولة أستراليا على اسم Short_name هو "AU".
types[]

string

مصفوفة تشير إلى أنواع مكوّن العنوان.
language_code

string

تمثّل هذه السمة اللغة المستخدمة لتنسيق هذه المكوّنات بتدوين CLDR.

AreaSummary

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل.

ملخّص من إنشاء الذكاء الاصطناعي للمنطقة التي يقع فيها المكان

الحقول
content_blocks[]

ContentBlock

وحدات المحتوى التي تشكّل ملخّص المنطقة كل قطعة لها موضوع منفصل حول المنطقة.

تحديد المصدر

معلومات حول مقدّمي البيانات لهذا المكان.

الحقول
provider

string

اسم مزوّد بيانات المكان
provider_uri

string

معرّف URI لمزوّد بيانات المكان.

BusinessStatus

حالة النشاط التجاري للمكان.

عمليات التعداد
BUSINESS_STATUS_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدمة.
OPERATIONAL المنشأة تعمل، وليس بالضرورة أن تكون مفتوحة الآن.
CLOSED_TEMPORARILY المنشأة مغلقة مؤقتًا.
CLOSED_PERMANENTLY المؤسسة مغلقة نهائيًا.

GenerativeSummary

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل.

ملخّص للمكان من إنشاء الذكاء الاصطناعي

الحقول
overview

LocalizedText

نظرة عامة على المكان.
description

LocalizedText

تمثّل هذه السمة الوصف المفصّل للمكان.
references

References

يشير هذا المصطلح إلى المراجع المستخدَمة لإنشاء وصف الملخّص.

OpeningHours

معلومات حول ساعة العمل الخاصة بالمكان

الحقول
periods[]

Period

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

string

سلاسل مترجَمة تصف ساعات العمل لهذا المكان، سلسلة واحدة لكل يوم من الأسبوع. سيتم ترك هذا الحقل فارغًا إذا كانت الساعات غير معروفة أو تعذَّر تحويلها إلى نص مترجَم. مثال: "الأحد: 18:00–06:00"
secondary_hours_type

SecondaryHoursType

سلسلة type تُستخدم لتحديد نوع ساعات العمل الثانوية.
special_days[]

SpecialDay

المعلومات المنظَّمة للأيام الخاصة التي تقع خلال الفترة التي تغطيها ساعات العمل المعروضة. الأيام الخاصة هي الأيام التي قد تؤثّر على ساعات العمل في مكان معيّن، مثل يوم عيد الميلاد. يمكنك ضبط Currents_opening_hours وcurrent_secondary_opening_hours إذا كانت هناك ساعات استثنائية.
open_now

bool

هل هذا المكان مفتوح الآن؟ يتم عرضها دائمًا ما لم تكن لدينا بيانات حول الوقت من اليوم أو المنطقة الزمنية لساعات العمل هذه.

المدة

الفترة التي يظل فيها المكان في حالة open_now.

الحقول
open

Point

الوقت الذي يبدأ فيه المكان مفتوحًا.
close

Point

الوقت الذي يبدأ فيه المكان مغلقًا.

نقطة

نقاط تغيُّر الحالة

الحقول
date

Date

التاريخ في المنطقة الزمنية المحلية للمكان
truncated

bool

ما إذا كان قد تم اقتطاع نقطة النهاية هذه أم لا. يحدث الاقتطاع عندما تكون الساعات الحقيقية خارج الأوقات التي نكون على استعداد لإرجاعها بينهما، لذلك نقتطع الساعات لتعود إلى هذه الحدود. ويضمن ذلك إرجاع الطلب خلال 24 * 7 ساعات من منتصف ليل يوم الطلب كحد أقصى.
day

int32

يوم من الأسبوع، كعدد صحيح في النطاق 0-6 0 هو الأحد و1 يوم الاثنين وما إلى ذلك.
hour

int32

الساعة مكوّنة من رقمَين. تتراوح من 00 إلى 23.
minute

int32

الدقيقة المكونة من رقمين. تتراوح من 00 إلى 59.

SecondaryHoursType

يشير ذلك المصطلح إلى نوع يُستخدَم لتحديد نوع ساعات العمل الثانوية.

عمليات التعداد
SECONDARY_HOURS_TYPE_UNSPECIFIED القيمة التلقائية عند عدم تحديد نوع الساعة الثانوي.
DRIVE_THROUGH ساعات العمل التي يمكن خلالها الدفع مقابل السيارة في المصارف أو المطاعم أو الصيدليات
HAPPY_HOUR ساعة التخفيضات.
DELIVERY ساعة التسليم.
TAKEOUT ساعة تناول الطعام في الخارج.
KITCHEN ساعة المطبخ.
BREAKFAST ساعة الفطور.
LUNCH ساعة الغداء.
DINNER ساعة العشاء.
BRUNCH ساعة الفطور المتأخر.
PICKUP ساعة استلام الطلب.
ACCESS ساعات الوصول إلى أماكن التخزين.
SENIOR_HOURS ساعات العمل الخاصة لكبار السن.
ONLINE_SERVICE_HOURS ساعات الخدمة على الإنترنت.

SpecialDay

المعلومات المنظَّمة للأيام الخاصة التي تقع خلال الفترة التي تغطيها ساعات العمل المعروضة. الأيام الخاصة هي الأيام التي قد تؤثّر على ساعات العمل في مكان معيّن، مثل يوم عيد الميلاد.

الحقول
date

Date

تاريخ هذا اليوم الخاص.

ParkingOptions

معلومات حول خيارات ركن السيارات في المكان يمكن أن يدعم موقف السيارات أكثر من خيار في نفس الوقت.

الحقول
free_parking_lot

bool

يضم المكان مواقف مجانية للسيارات.
paid_parking_lot

bool

يضم المكان مواقف للسيارات مقابل رسوم.
free_street_parking

bool

يوفّر المكان مواقف مجانية للسيارات في الشارع.
paid_street_parking

bool

يوفّر المكان موقفًا للسيارات في الشارع مقابل رسوم.
valet_parking

bool

يوفّر المكان خدمة صفّ السيارات من قِبل موظفي الفندق.
free_garage_parking

bool

يوفّر المكان موقفًا مجانيًا للسيارات في مرآب.
paid_garage_parking

bool

يوفّر المكان موقف سيارات مدفوع الأجر في مرآب.

PaymentOptions

خيارات الدفع التي يقبلها المكان

الحقول
accepts_credit_cards

bool

يقبل المكان بطاقات الائتمان كالدفع.
accepts_debit_cards

bool

يقبل المكان بطاقات السحب الآلي كطريقة دفع.
accepts_cash_only

bool

يقبل المكان الدفع النقدي فقط. قد تقبل الأماكن التي تتضمّن هذه السمة طرق دفع أخرى.
accepts_nfc

bool

المكان يقبل عمليات الدفع من خلال الاتصال القصير المدى (NFC).

PlusCode

رمز Plus Codes (http://plus.codes) هو مرجع موقع بتنسيقين: رمز عام يحدد 14MX14m (1/8000 من الدرجة) أو مستطيلاً أصغر حجمًا، ورمزًا مركّبًا، حيث يتم استبدال البادئة بالموقع المرجعي.

الحقول
global_code

string

الرمز العالمي للمكان (الكامل)، مثل "9FWM33GV+HQ"، الذي يمثّل مساحة 1/8000 x 1/8000 درجة (حوالي 14 × 14 متر)
compound_code

string

الرمز المركَّب للمكان، مثل "33GV+HQ، رامبيرغ، النرويج"، الذي يحتوي على لاحقة الرمز العالمي ويستبدل البادئة باسم منسَّق لكيان مرجعي

SubDestination

اسم المورد الخاص بالمكان ورقم تعريف الوجهات الفرعية المرتبطة بالمكان على سبيل المثال، تمثِّل مواصلات المطار المختلفة وجهات مختلفة لمطار.

الحقول
name

string

اسم مورد الوجهة الفرعية.
id

string

رقم تعريف المكان للوجهة الفرعية.

PriceLevel

مستوى سعر المكان.

عمليات التعداد
PRICE_LEVEL_UNSPECIFIED مستوى سعر المكان غير محدّد أو غير معروف.
PRICE_LEVEL_FREE يقدّم المكان خدمات مجانية.
PRICE_LEVEL_INEXPENSIVE المكان يقدم خدمات غير مكلفة.
PRICE_LEVEL_MODERATE يقدّم المكان خدمات بأسعار معتدلة.
PRICE_LEVEL_EXPENSIVE المكان يقدّم خدمات باهظة الثمن.
PRICE_LEVEL_VERY_EXPENSIVE المكان يقدم خدمات مكلفة للغاية.

المراجع

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل.

الإشارة إلى المحتوى التوليدي المرتبط به

الحقول
reviews[]

Review

المراجعات التي يتم استخدامها كمراجع.
places[]

string

قائمة أسماء الموارد للأماكن المُشار إليها يمكن استخدام هذا الاسم في واجهات برمجة التطبيقات الأخرى التي تقبل أسماء موارد الأماكن.

مراجعة

تمثّل هذه السمة معلومات عن مراجعة لمكان.

الحقول
name

string

مرجع يمثّل مراجعة هذا المكان ويمكن استخدامه للبحث عن مراجعة هذا المكان مرة أخرى (ويسمى أيضًا اسم "مورد" واجهة برمجة التطبيقات: places/{place_id}/reviews/{review}).
relative_publish_time_description

string

سلسلة من تنسيقات الوقت الأخيرة تعبّر عن وقت المراجعة مقارنةً بالوقت الحالي في نموذج مناسب للغة والبلد
text

LocalizedText

تمثّل هذه السمة النص المترجَم للمراجعة.
original_text

LocalizedText

نص المراجعة بلغته الأصلية.
rating

double

رقم بين 1.0 و5.0، ويسمى أيضًا عدد النجوم.
author_attribution

AuthorAttribution

مؤلف هذه المراجعة.
publish_time

Timestamp

طابع زمني للمراجعة

SearchNearbyRequest

طلب نموذج أوّلي للبحث عن قرب.

الحقول
language_code

string

سيتم عرض تفاصيل المكان باللغة المفضّلة إن توفّرت. إذا كان رمز اللغة غير محدّد أو غير معروف، قد يتم عرض تفاصيل مكان أي لغة، مع تفضيل اللغة الإنجليزية في حال توفّر هذه التفاصيل.

القائمة الحالية باللغات المعتمدة: https://developers.google.com/maps/faq#languagesupport.
region_code

string

رمز البلد/المنطقة يونيكود (CLDR) للموقع الجغرافي الذي يأتي منه الطلب تُستخدَم هذه المَعلمة لعرض تفاصيل المكان، مثل اسم المكان الخاص بمنطقة معيّنة، إذا كان متاحًا. يمكن أن تؤثر المَعلمة في النتائج استنادًا إلى القانون الساري.

لمزيد من المعلومات، يُرجى الاطّلاع على https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

تجدر الإشارة إلى أنّه لا يمكن حاليًا استخدام رموز المناطق المكوَّنة من 3 أرقام.
included_types[]

string

تم تضمين نوع المكان (على سبيل المثال، "مطعم" أو "gas_station") من https://developers.google.com/maps/documentation/places/web-service/place-types.

يمكن تحديد ما يصل إلى 50 نوعًا من الجدول "أ".

في حال وجود أي أنواع متعارضة، على سبيل المثال، يظهر أحد الأنواع في كل من include_types وexcluded_types، يتم عرض الخطأ ERROR_{9}.

إذا تم تحديد نوع مكان مع قيود متعددة الأنواع، يتم عرض الأماكن التي تستوفي جميع القيود فقط. على سبيل المثال، إذا كان لدينا {included_types = ["Restaurant"], المستبعدة_primary_types = ["مطعم"]}، توفّر الأماكن التي تم إرجاعها الخدمات المتعلّقة بالمطعم ولكنها لا تعمل في الأساس على أنّها "مطاعم".
excluded_types[]

string

تم استبعاد نوع المكان (على سبيل المثال، "مطعم" أو "gas_station") من https://developers.google.com/maps/documentation/places/web-service/place-types.

يمكن تحديد ما يصل إلى 50 نوعًا من الجدول "أ".

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

في حال وجود أي أنواع متعارضة، على سبيل المثال، يظهر أحد الأنواع في كل من include_types وexcluded_types، يتم عرض الخطأ ERROR_{9}.

إذا تم تحديد نوع مكان مع قيود متعددة الأنواع، يتم عرض الأماكن التي تستوفي جميع القيود فقط. على سبيل المثال، إذا كان لدينا {included_types = ["Restaurant"], المستبعدة_primary_types = ["مطعم"]}، توفّر الأماكن التي تم إرجاعها الخدمات المتعلّقة بالمطعم ولكنها لا تعمل في الأساس على أنّها "مطاعم".
included_primary_types[]

string

تم تضمين نوع "المكان" الأساسي (مثل "مطعم" أو "محطة وقود") من https://developers.google.com/maps/documentation/places/web-service/place-types. يمكن أن يكون للمكان نوع أساسي واحد فقط من جدول الأنواع المتوافقة المرتبط به.

يمكن تحديد ما يصل إلى 50 نوعًا من الجدول "أ".

في حال كان هناك أي أنواع أساسية متعارضة، على سبيل المثال، يظهر أحد الأنواع في كل من sort_primary_types وexclusion_primary_types، فسيتم عرض خطأ ATTRIBUTE_{9}.

إذا تم تحديد نوع مكان مع قيود متعددة الأنواع، يتم عرض الأماكن التي تستوفي جميع القيود فقط. على سبيل المثال، إذا كان لدينا {included_types = ["Restaurant"], المستبعدة_primary_types = ["مطعم"]}، توفّر الأماكن التي تم إرجاعها الخدمات المتعلّقة بالمطعم ولكنها لا تعمل في الأساس على أنّها "مطاعم".
excluded_primary_types[]

string

تم استبعاد نوع المكان الأساسي (مثل "مطعم" أو "محطة وقود") من https://developers.google.com/maps/documentation/places/web-service/place-types.

يمكن تحديد ما يصل إلى 50 نوعًا من الجدول "أ".

في حال كان هناك أي أنواع أساسية متعارضة، على سبيل المثال، يظهر أحد الأنواع في كل من sort_primary_types وexclusion_primary_types، فسيتم عرض خطأ ATTRIBUTE_{9}.

إذا تم تحديد نوع مكان مع قيود متعددة الأنواع، يتم عرض الأماكن التي تستوفي جميع القيود فقط. على سبيل المثال، إذا كان لدينا {included_types = ["Restaurant"], المستبعدة_primary_types = ["مطعم"]}، توفّر الأماكن التي تم إرجاعها الخدمات المتعلّقة بالمطعم ولكنها لا تعمل في الأساس على أنّها "مطاعم".
max_result_count

int32

الحد الأقصى لعدد النتائج المطلوب عرضها. ويجب أن تتراوح القيمة بين 1 و20 (الخيار التلقائي)، بشكل شامل. وفي حال عدم ضبط الرقم، يعود إلى الحدّ الأقصى المسموح به. إذا تم تعيين الرقم على سالب أو تجاوز الحد الأقصى، يتم عرض خطأ POINTS_{9}.
location_restriction

LocationRestriction

مطلوبة. المنطقة المراد البحث فيها.
rank_preference

RankPreference

كيفية ترتيب النتائج في الردّ

LocationRestriction

المنطقة المراد البحث فيها.

الحقول

حقل الاتحاد type

يمكن أن يكون الحقل "type" واحدًا فقط مما يلي:
circle

Circle

دائرة محددة بواسطة نقطة المركز ونصف القطر.

RankPreference

كيفية ترتيب النتائج في الردّ

عمليات التعداد
RANK_PREFERENCE_UNSPECIFIED لم يتم ضبط قيمة RankPreferences. سيتم استخدام الترتيب حسب مدى الرواج تلقائيًا.
DISTANCE يعمل على ترتيب النتائج حسب المسافة.
POPULARITY لترتيب النتائج حسب رواجها.

SearchNearbyResponse

نموذج الرد للبحث عن الأجهزة المجاورة.

الحقول
places[]

Place

قائمة بالأماكن التي تستوفي متطلبات المستخدم، مثل أنواع الأماكن وعدد الأماكن والقيود المفروضة على الموقع الجغرافي المحدّد

SearchTextRequest

طلب نموذج أوّلي لـ SearchText.

الحقول
text_query

string

مطلوبة. طلب البحث النصي للبحث النصي.
language_code

string

سيتم عرض تفاصيل المكان باللغة المفضّلة إن توفّرت. إذا كان رمز اللغة غير محدّد أو غير معروف، قد يتم عرض تفاصيل مكان أي لغة، مع تفضيل اللغة الإنجليزية في حال توفّر هذه التفاصيل.

القائمة الحالية باللغات المعتمدة: https://developers.google.com/maps/faq#languagesupport.
region_code

string

رمز البلد/المنطقة يونيكود (CLDR) للموقع الجغرافي الذي يأتي منه الطلب تُستخدَم هذه المَعلمة لعرض تفاصيل المكان، مثل اسم المكان الخاص بمنطقة معيّنة، إذا كان متاحًا. يمكن أن تؤثر المَعلمة في النتائج استنادًا إلى القانون الساري.

لمزيد من المعلومات، يُرجى الاطّلاع على https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

تجدر الإشارة إلى أنّه لا يمكن حاليًا استخدام رموز المناطق المكوَّنة من 3 أرقام.
rank_preference

RankPreference

كيفية ترتيب النتائج في الردّ
included_type

string

نوع المكان المطلوب. القائمة الكاملة للأنواع المتوافقة: https://developers.google.com/maps/documentation/places/web-service/place-types. يجب استخدام نوع واحد مضمّن فقط.
open_now

bool

يُستخدم لحصر البحث على الأماكن المفتوحة حاليًا. والقيمة التلقائية هي false.
min_rating

double

يمكنك تصفية النتائج التي يقل متوسط تقييم المستخدمين فيها عن هذا الحدّ الأقصى تمامًا. يجب أن تكون القيمة الصالحة عائمة بين 0 و5 (بشكل شامل) بوتيرة 0.5، أي [0، 0.5، 1.0، ... ، 5.0] بشكل شامل. سيتم تقريب تقييم الإدخال إلى أقرب 0.5(سقف). على سبيل المثال، سيؤدي التقييم 0.6 إلى إزالة جميع النتائج ذات التقييم الأقل من 1.0.
max_result_count
(deprecated)

int32

مهملة: يمكنك استخدام page_size بدلاً منها.

تمثّل هذه السمة الحد الأقصى لعدد النتائج التي يمكن عرضها لكل صفحة. إذا كان عدد النتائج المتاحة أكبر من max_result_count، يتم عرض next_page_token والتي يمكن تمريرها إلى page_token للحصول على الصفحة التالية من النتائج في الطلبات اللاحقة. إذا تم تقديم 0 أو لم يتم تقديم أي قيمة، يتم استخدام القيمة التلقائية 20. الحد الأقصى للقيمة هو 20، وسيتم فرض القيمة التي تزيد عن 20 لتكون 20. سيؤدي ذلك إلى عرض رسالة الخطأ POINTS_{6/} في القيم السلبية.

إذا تم تحديد كل من max_result_count وpage_size، سيتم تجاهل max_result_count.
page_size

int32

اختياريّ. تمثّل هذه السمة الحد الأقصى لعدد النتائج التي يمكن عرضها لكل صفحة. إذا كان عدد النتائج المتاحة أكبر من page_size، يتم عرض next_page_token والتي يمكن تمريرها إلى page_token للحصول على الصفحة التالية من النتائج في الطلبات اللاحقة. إذا تم تقديم 0 أو لم يتم تقديم أي قيمة، يتم استخدام القيمة التلقائية 20. الحد الأقصى للقيمة هو 20، وسيتم ضبط القيم الأعلى من 20 على 20. سيؤدي ذلك إلى عرض رسالة الخطأ POINTS_{6/} في القيم السلبية.

إذا تم تحديد كل من max_result_count وpage_size، سيتم تجاهل max_result_count.
page_token

string

اختياريّ. رمز مميز للصفحة تم استلامه من مكالمة سابقة عبر TextSearch. يُرجى توفير هذا الحقل لاسترداد الصفحة التالية.

عند التقسيم على صفحات، يجب أن تتطابق جميع المَعلمات بخلاف page_token وpage_size وmax_result_count المقدَّمة إلى TextSearch مع الاستدعاء الأولي الذي وفّر الرمز المميّز للصفحة. وفي حال عدم تنفيذ ذلك، يتم عرض خطأ POINTS_Quick.
price_levels[]

PriceLevel

يُستخدم لتقييد البحث على الأماكن التي تم وضع علامة عليها كمستويات أسعار معيّنة. يمكن للمستخدمين اختيار أي مجموعات من مستويات الأسعار. اختيار جميع مستويات السعر تلقائيًا
strict_type_filtering

bool

يُستخدم لتعيين تصفية الأنواع المتشددة لنوع السمة المضمنة. إذا تم ضبطها على "صحيح"، سيتم عرض النتائج من النوع نفسه فقط. يكون الإعداد التلقائي بالقيمة "خطأ".
location_bias

LocationBias

المنطقة المراد البحث فيها. هذا الموقع بمثابة تحيز مما يعني أنه قد يتم عرض النتائج حول موقع معين. لا يمكن الضبط مع location_restriction.
location_restriction

LocationRestriction

المنطقة المراد البحث فيها. يمثل هذا الموقع الجغرافي قيدًا مما يعني أنه لن يتم عرض النتائج خارج هذا الموقع الجغرافي. لا يمكن ضبطه باستخدام location_bias.
ev_options

EVOptions

اختياريّ. ضبط خيارات المركبة الكهربائية القابلة للبحث لطلب البحث عن مكان

EVOptions

خيارات يمكن البحث عنها للمركبة الكهربائية لطلب البحث عن مكان

الحقول
minimum_charging_rate_kw

double

اختياريّ. الحد الأدنى لمعدل الشحن المطلوب بالكيلوواط تتم فلترة المكان الذي يكون معدّل الشحن أقل من المعدّل المحدّد.
connector_types[]

EVConnectorType

اختياريّ. قائمة بأنواع موصِّلات المركبات الكهربائية المفضّلة يتم استبعاد المكان الذي لا يتيح أيًا من أنواع الموصلات المدرجة.

LocationBias

المنطقة المراد البحث فيها. هذا الموقع بمثابة تحيز مما يعني أنه قد يتم عرض النتائج حول موقع معين.

الحقول

حقل الاتحاد type

يمكن أن يكون الحقل "type" واحدًا فقط مما يلي:
rectangle

Viewport

مربع مستطيل يحدد الزاوية الشمالية الشرقية والجنوبية الغربية. يجب أن تكون القيمة rectangle.high() النقطة الشمالية الشرقية لإطار العرض المستطيل. يجب أن تكون القيمة rectangle.low() عند النقطة الجنوبية الغربية لإطار عرض المستطيل. لا يمكن أن يكون rectangle.low().latitude() أكبر من rectangle.high().latitude(). سينتج عن ذلك نطاق خط عرض فارغ. لا يمكن أن يكون إطار العرض المستطيل أعرض من 180 درجة.
circle

Circle

دائرة محددة بواسطة نقطة المركز ونصف القطر.

LocationRestriction

المنطقة المراد البحث فيها. يمثل هذا الموقع الجغرافي قيدًا مما يعني أنه لن يتم عرض النتائج خارج هذا الموقع الجغرافي.

الحقول

حقل الاتحاد type

يمكن أن يكون الحقل "type" واحدًا فقط مما يلي:
rectangle

Viewport

مربع مستطيل يحدد الزاوية الشمالية الشرقية والجنوبية الغربية. يجب أن تكون القيمة rectangle.high() النقطة الشمالية الشرقية لإطار العرض المستطيل. يجب أن تكون القيمة rectangle.low() عند النقطة الجنوبية الغربية لإطار عرض المستطيل. لا يمكن أن يكون rectangle.low().latitude() أكبر من rectangle.high().latitude(). سينتج عن ذلك نطاق خط عرض فارغ. لا يمكن أن يكون إطار العرض المستطيل أعرض من 180 درجة.

RankPreference

كيفية ترتيب النتائج في الردّ

عمليات التعداد
RANK_PREFERENCE_UNSPECIFIED بالنسبة إلى استعلام فئوي مثل "مطاعم في مدينة نيويورك"، يكون RELEVANCE الافتراضي هو. بالنسبة إلى طلبات البحث غير الفئوية، مثل "Mountain View, CA"، ننصحك بترك المفضلة بدون ضبط.
DISTANCE يعمل على ترتيب النتائج حسب المسافة.
RELEVANCE يعمل على ترتيب النتائج حسب مدى صلتها بموضوع البحث. يتم تحديد ترتيب الترتيب حسب مكدّس الترتيب العادي.

SearchTextResponse

نموذج الاستجابة الخاص بـ SearchText.

الحقول
places[]

Place

قائمة بالأماكن التي تستوفي معايير البحث النصي للمستخدِم.
contextual_contents[]

ContextualContent

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل.

قائمة بالمحتوى السياقي حيث يرتبط كل إدخال بالمكان المقابل في الفهرس نفسه في حقل الأماكن. يُفضَّل استخدام المحتوى ذي الصلة بـ text_query في الطلب. إذا لم يكن المحتوى السياقي متاحًا لأحد الأماكن، سيتم عرض محتوى غير سياقي. وسيكون فارغًا فقط عندما يكون المحتوى غير متوفّر لهذا المكان. ويجب أن تحتوي هذه القائمة على العديد من الإدخالات مثل قائمة الأماكن إذا تم طلبها.
next_page_token

string

هو رمز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. إذا تم حذف هذا الحقل أو كان فارغًا، لن تكون هناك صفحات لاحقة.