Package google.maps.places.v1

الفهرس

أماكن

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

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

تعرض هذه الطريقة التوقعات الخاصة بالمدخلات المحدّدة.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/cloud-platform
GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

الحصول على وسائط صورة باستخدام سلسلة مرجعية للصورة

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/cloud-platform
GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

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

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/cloud-platform
SearchNearby

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

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

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/cloud-platform
SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

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

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/cloud-platform

AddressDescriptor

تمثّل هذه السمة وصفًا مرتبطًا بموقع جغرافي. تتضمّن مجموعة مرتّبة من المعالم القريبة والمناطق الدقيقة التي تحتوي على الموقع الجغرافي المستهدَف وعلاقتها به.

الحقول
landmarks[]

Landmark

قائمة مرتبة حسب الأهمية بالمعالم القريبة يتم ترتيب المعالم الأكثر شهرة والأقرب إليك أولاً.
areas[]

Area

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

منطقة

معلومات المنطقة وعلاقتها بالموقع الجغرافي المستهدَف

تشمل المناطق الأماكن الفرعية الدقيقة والأحياء والمجمّعات السكنية الكبيرة التي تفيد في وصف الموقع الجغرافي.

الحقول
name

string

تمثّل هذه السمة اسم مورد المنطقة.
place_id

string

تمثّل هذه السمة رقم تعريف المكان الخاص بالمنطقة.
display_name

LocalizedText

تمثّل هذه السمة الاسم المعروض للمنطقة.
containment

Containment

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

الاحتواء

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

عمليات التعداد
CONTAINMENT_UNSPECIFIED لم يتم تحديد الاحتواء.
WITHIN يقع الموقع الجغرافي المستهدَف ضمن منطقة المساحة، بالقرب من المركز.
OUTSKIRTS يقع الموقع الجغرافي المستهدَف ضمن منطقة المساحة، بالقرب من الحافة.
NEAR الموقع الجغرافي المستهدَف خارج منطقة المساحة، ولكنّه قريب منها.

مَعلم

معلومات أساسية عن المعلم وعلاقته بالموقع الجغرافي المستهدَف

المعالم هي أماكن بارزة يمكن استخدامها لوصف موقع جغرافي.

الحقول
name

string

تمثّل هذه السمة اسم المرجع الخاص بالمعلم.
place_id

string

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

LocalizedText

الاسم المعروض للمعلم.
types[]

string

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

SpatialRelationship

تحدّد هذه السمة العلاقة المكانية بين الموقع المستهدَف والمعلم.
straight_line_distance_meters

float

تمثّل هذه السمة المسافة بين النقطة المركزية للهدف والنقطة المركزية للمعلم، وذلك بوحدة المتر. في بعض الحالات، يمكن أن تكون هذه القيمة أكبر من travel_distance_meters.
travel_distance_meters

float

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

SpatialRelationship

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

عمليات التعداد
NEAR هذه هي العلاقة التلقائية عندما لا ينطبق أي مما يلي.
WITHIN يحتوي المعلم على شكل هندسي مكاني ويقع الهدف ضمن حدوده.
BESIDE يكون الهدف مجاورًا مباشرةً للمعلم.
ACROSS_THE_ROAD يكون الهدف مقابل المعلم مباشرةً على الجانب الآخر من الطريق.
DOWN_THE_ROAD على الطريق نفسه الذي يقع فيه المعلم، ولكن ليس بجانبه أو مقابله
AROUND_THE_CORNER ليس على المسار نفسه الذي يقع فيه المعلم، ولكن يمكن الوصول إليه من خلال انعطاف واحد.
BEHIND قريب من هيكل المعلم ولكن بعيد عن مداخل الشارع

AuthorAttribution

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

الحقول
display_name

string

تمثّل هذه السمة اسم مؤلف Photo أو Review.
uri

string

تمثّل هذه السمة معرّف الموارد المنتظم (URI) لمؤلف Photo أو Review.
photo_uri

string

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

AutocompletePlacesRequest

طلب proto لـ 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

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

string

اختياريّ. تضمين النتائج في المناطق المحدّدة فقط، والتي يتم تحديدها على أنّها ما يصل إلى 15 رمزًا من رموز 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

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

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

bool

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

string

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

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

ننصحك باتّباع الإرشادات التالية:

  • استخدِم رموز الجلسات لجميع طلبات Place Autocomplete.
  • إنشاء رمز مميّز جديد لكل جلسة ننصح باستخدام معرّف فريد عالميًا من الإصدار 4.
  • تأكَّد من أنّ بيانات الاعتماد المستخدَمة في جميع طلبات Place Autocomplete وPlace Details وAddress Validation خلال جلسة واحدة تنتمي إلى مشروع Cloud Console نفسه.
  • احرص على تمرير رمز مميّز فريد للجلسة لكل جلسة جديدة. سيؤدي استخدام الرمز المميز نفسه لأكثر من جلسة واحدة إلى تحصيل رسوم من كل طلب على حدة.
include_pure_service_area_businesses

bool

اختياريّ. أدرِج الأنشطة التجارية القاصرة على منطقة الخدمة إذا تم ضبط الحقل على "صحيح". المؤسسة ضمن منطقة الخدمة هي مؤسسة تقدّم خدماتها من خلال الانتقال إلى المواقع الجغرافية للعملاء أو توصيل الخدمة إليهم مباشرةً، ولكنّها لا تقدّم خدماتها لهم في عنوانها. على سبيل المثال، خدمات التنظيف أو السباكة ولا تتضمّن هذه الأنشطة التجارية عنوانًا أو موقعًا جغرافيًا على "خرائط Google". لن تعرض خدمة "أماكن" حقولاً تتضمّن location وplus_code وغيرها من الحقول ذات الصلة بالموقع الجغرافي لهذه الأنشطة التجارية.

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 إذا تم تحديد المطابقة من خلال معايير أخرى غير مطابقة السلسلة (على سبيل المثال، تصحيحات إملائية أو ترجمات صوتية).

هذه القيم هي إزاحات أحرف Unicode الخاصة بـ 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

تمثّل هذه السمة ميزات إضافية لإزالة الغموض (مثل مدينة أو منطقة) من أجل تحديد المكان بشكل أفضل أو تحسين طلب البحث.

دائرة

دائرة تتضمّن LatLng كمركز ونصف قطر

الحقول
center

LatLng

مطلوب. خط العرض وخط الطول في المنتصف

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

double

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

ContentBlock

هي مجموعة من المحتوى يمكن عرضها بشكل فردي.

الحقول
content

LocalizedText

المحتوى ذو الصلة بالموضوع
referenced_places[]

string

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

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

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

الحقول
text

string
highlighted_text_ranges[]

HighlightedTextRange

قائمة بنطاقات النص المميّز.

HighlightedTextRange

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

الحقول
start_index

int32
end_index

int32

EVChargeOptions

معلومات حول محطة شحن المركبات الكهربائية المستضافة في "المكان" تتّبع المصطلحات 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 موصّل من النوع 1 وفقًا لمعيار J1772
EV_CONNECTOR_TYPE_TYPE_2 موصّل من النوع 2 وفقًا للمعيار IEC 62196 يُشار إليها غالبًا باسم MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO موصّل من نوع CHAdeMO
EV_CONNECTOR_TYPE_CCS_COMBO_1 نظام الشحن المجمّع (تيار متردد وتيار مباشر) استنادًا إلى SAE وصلة من النوع 1 J-1772
EV_CONNECTOR_TYPE_CCS_COMBO_2 نظام الشحن المجمّع (تيار متردد وتيار مباشر) استنادًا إلى موصّل Mennekes من النوع 2
EV_CONNECTOR_TYPE_TESLA الموصل العام لـ TESLA هذا هو معيار 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 مقبس حائط غير محدَّد
EV_CONNECTOR_TYPE_NACS نظام الشحن في أمريكا الشمالية (NACS)، وهو نظام موحّد وفقًا لمعيار SAE J3400

FuelOptions

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

الحقول
fuel_prices[]

FuelPrice

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

FuelPrice

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

الحقول
type

FuelType

تمثّل هذه السمة نوع الوقود.
price

Money

تمثّل هذه السمة سعر الوقود.
update_time

Timestamp

يشير هذا العنصر إلى وقت آخر تعديل لسعر الوقود.

FuelType

أنواع الوقود

عمليات التعداد
FUEL_TYPE_UNSPECIFIED نوع الوقود غير محدَّد
DIESEL وقود الديزل
DIESEL_PLUS وقود الديزل
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 ‫100 نقطة بيع
LPG الغاز النفطي المسال
E80 E 80.
E85 ‫E 85
E100 ‫E 100
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، ضِمنًا. إذا كانت القيمة خارج النطاق المسموح به، سيتم عرض الخطأ INVALID_ARGUMENT.

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

int32

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

يجب تحديد قيمة واحدة على الأقل من max_height_px أو max_width_px. إذا لم يتم تحديد max_height_px أو max_width_px، سيتم عرض الخطأ INVALID_ARGUMENT.
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

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

يُرجى العِلم أنّ رموز المناطق المكوّنة من 3 أرقام غير متاحة حاليًا.
session_token

string

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

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

ننصحك باتّباع الإرشادات التالية:

  • استخدِم رموز الجلسات لجميع طلبات Place Autocomplete.
  • إنشاء رمز مميّز جديد لكل جلسة ننصح باستخدام معرّف فريد عالميًا من الإصدار 4.
  • تأكَّد من أنّ بيانات الاعتماد المستخدَمة في جميع طلبات Place Autocomplete وPlace Details وAddress Validation خلال جلسة واحدة تنتمي إلى مشروع Cloud Console نفسه.
  • احرص على تمرير رمز مميّز فريد للجلسة لكل جلسة جديدة. سيؤدي استخدام الرمز المميز نفسه لأكثر من جلسة واحدة إلى تحصيل رسوم من كل طلب على حدة.

صورة

معلومات عن صورة لمكان

الحقول
name

string

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

int32

تمثّل هذه السمة الحد الأقصى للعرض المتاح بوحدة البكسل.
height_px

int32

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

AuthorAttribution

تمثّل هذه السمة مؤلّفي الصورة.
flag_content_uri

string

رابط يمكن للمستخدمين من خلاله الإبلاغ عن مشكلة في الصورة
google_maps_uri

string

رابط لعرض الصورة على "خرائط Google"

PhotoMedia

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

الحقول
name

string

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

string

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

مكان

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

الحقول
name

string

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

string

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

LocalizedText

تمثّل هذه السمة الاسم المترجَم للمكان، وهو مناسب كوصف قصير يمكن للمستخدم قراءته. على سبيل المثال، "Google Sydney" أو "ستاربكس" أو "بيرمونت" أو غير ذلك.
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. قد يكون النوع الأساسي مفقودًا إذا لم يكن النوع الأساسي للمكان نوعًا متوافقًا. عند توفّر نوع أساسي، يكون دائمًا أحد الأنواع في الحقل 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

عنوان قصير يمكن لشخص عادي قراءته لهذا المكان
postal_address

PostalAddress

تمثّل هذه السمة العنوان بتنسيق العنوان البريدي.
address_components[]

AddressComponent

عناصر متكرّرة لكل مستوى من مستويات الموقع الجغرافي يُرجى ملاحظة الحقائق التالية حول مصفوفة address_components[]: - قد تحتوي مصفوفة مكوّنات العنوان على مكوّنات أكثر من formatted_address. - لا تتضمّن المصفوفة بالضرورة جميع الكيانات السياسية التي تحتوي على عنوان، باستثناء تلك المضمّنة في formatted_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

تمثّل ساعات العمل العادية. يُرجى العِلم أنّه إذا كان المكان مفتوحًا دائمًا (24 ساعة)، لن يتم ضبط الحقل close. يمكن للعملاء الاعتماد على أنّ ساعات العمل المتاحة دائمًا (24 ساعة) يتم تمثيلها كفترة open تحتوي على day بالقيمة 0 وhour بالقيمة 0 وminute بالقيمة 0.
time_zone

TimeZone

المنطقة الزمنية لقاعدة بيانات المناطق الزمنية التابعة لهيئة IANA على سبيل المثال، "America/New_York".
photos[]

Photo

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

string

عنوان المكان بتنسيق 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

ملخّص من إنشاء الذكاء الاصطناعي حول المكان
containing_places[]

ContainingPlace

قائمة بالأماكن التي يقع فيها المكان الحالي
address_descriptor

AddressDescriptor

تمثّل هذه السمة واصف العنوان الخاص بالمكان. تتضمّن أوصاف العناوين معلومات إضافية تساعد في وصف موقع جغرافي باستخدام المعالم والمناطق. يمكنك الاطّلاع على التغطية الإقليمية لواصفات العناوين في https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.
price_range

PriceRange

نطاق الأسعار المرتبط بمكان.
review_summary

ReviewSummary

ملخّص من إنشاء الذكاء الاصطناعي للمكان باستخدام مراجعات المستخدمين
ev_charge_amenity_summary

EvChargeAmenitySummary

ملخّص عن وسائل الراحة بالقرب من محطة شحن المركبات الكهربائية
neighborhood_summary

NeighborhoodSummary

ملخّص لنقاط الاهتمام القريبة من المكان
consumer_alert

ConsumerAlert

رسالة تنبيه المستهلك للمكان عندما نرصد نشاطًا مريبًا في المراجعات يخصّ نشاطًا تجاريًا أو نرصد انتهاكًا من نشاط تجاري لسياساتنا
utc_offset_minutes

int32

عدد الدقائق التي يتم حاليًا إزاحتها من التوقيت العالمي المنسّق في المنطقة الزمنية لهذا المكان يتم التعبير عن ذلك بالدقائق لتوفير التوافق مع المناطق الزمنية التي يتم إزاحتها بمقدار كسور من الساعة، مثل 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

معلومات حول خيارات تسهيل الاستخدام التي يوفّرها المكان
pure_service_area_business

bool

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

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

تحديد المصدر

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

الحقول
provider

string

تمثّل هذه السمة اسم مقدّم بيانات المكان.
provider_uri

string

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

BusinessStatus

تمثّل هذه السمة حالة النشاط التجاري للمكان.

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

ConsumerAlert

رسالة تنبيه المستهلك للمكان عندما نرصد نشاطًا مريبًا في المراجعات يخصّ نشاطًا تجاريًا أو نرصد انتهاكًا من نشاط تجاري لسياساتنا

الحقول
overview

string

نظرة عامة على رسالة تنبيه المستهلك
details

Details

تفاصيل رسالة تنبيه المستهلكƒ
language_code

string

رمز اللغة لرسالة تنبيه المستهلك هذا هو رمز اللغة BCP 47.

التفاصيل

تفاصيل رسالة تنبيه المستهلك

الحقول
title

string

العنوان الذي سيظهر مع الوصف
description

string

وصف رسالة تنبيه المستهلك

ContainingPlace

معلومات عن المكان الذي يقع فيه هذا المكان

الحقول
name

string

اسم المورد الخاص بالمكان الذي يقع فيه هذا المكان
id

string

رقم تعريف المكان الذي يقع فيه هذا المكان

EvChargeAmenitySummary

ملخّص عن وسائل الراحة بالقرب من محطة شحن المركبات الكهربائية ينطبق ذلك فقط على الأماكن من النوع electric_vehicle_charging_station. يتمّ توفير الحقل overview دائمًا، بينما تكون الحقول الأخرى اختيارية.

الحقول
overview

ContentBlock

نظرة عامة على وسائل الراحة المتوفّرة ويجب توفير هذه المعلومات.
coffee

ContentBlock

ملخّص عن خيارات المقاهي القريبة
restaurant

ContentBlock

ملخّص للمطاعم القريبة
store

ContentBlock

ملخّص عن المتاجر المجاورة
flag_content_uri

string

رابط يمكن للمستخدمين من خلاله الإبلاغ عن مشكلة في الملخّص
disclosure_text

LocalizedText

رسالة الإفصاح عن استخدام الذكاء الاصطناعي "تم التلخيص باستخدام Gemini" (والصيغ المتوافقة مع اللغة المحلية) سيتم عرضها باللغة المحدّدة في الطلب إذا كانت متاحة.

GenerativeSummary

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

الحقول
overview

LocalizedText

تمثّل هذه السمة النظرة العامة على المكان.
overview_flag_content_uri

string

رابط يمكن للمستخدمين من خلاله الإبلاغ عن مشكلة في الملخّص العام
disclosure_text

LocalizedText

رسالة الإفصاح عن استخدام الذكاء الاصطناعي "تم التلخيص باستخدام Gemini" (والصيغ المتوافقة مع اللغة المحلية) سيتم عرضها باللغة المحدّدة في الطلب إذا كانت متاحة.

NeighborhoodSummary

ملخّص لنقاط الاهتمام القريبة من المكان

الحقول
overview

ContentBlock

تمثّل هذه السمة ملخّصًا عامًا عن الحي.
description

ContentBlock

تمثّل هذه السمة وصفًا مفصّلاً للحي.
flag_content_uri

string

رابط يمكن للمستخدمين من خلاله الإبلاغ عن مشكلة في الملخّص
disclosure_text

LocalizedText

رسالة الإفصاح عن استخدام الذكاء الاصطناعي "تم التلخيص باستخدام Gemini" (والصيغ المتوافقة مع اللغة المحلية) سيتم عرضها باللغة المحدّدة في الطلب إذا كانت متاحة.

OpeningHours

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

الحقول
periods[]

Period

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

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

ملاحظة: ترتيب مصفوفة periods مستقل عن ترتيب مصفوفة weekday_descriptions. لا تفترض أنّها ستبدأ في اليوم نفسه.
weekday_descriptions[]

string

سلاسل مترجمة تصف ساعات عمل هذا المكان، سلسلة واحدة لكل يوم من أيام الأسبوع

ملاحظة: يتم تحديد ترتيب الأيام وبداية الأسبوع حسب اللغة والمنطقة. لا يرتبط ترتيب مصفوفة periods بترتيب مصفوفة weekday_descriptions. لا تفترض أنّها ستبدأ في اليوم نفسه.

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

SecondaryHoursType

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

SpecialDay

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

Timestamp

في المرة التالية التي تبدأ فيها فترة ساعات العمل الحالية، وذلك خلال مدة تصل إلى 7 أيام في المستقبل لا يتم ملء هذا الحقل إلا إذا كانت فترة ساعات العمل غير نشطة في وقت عرض الطلب.
next_close_time

Timestamp

المرّة التالية التي تنتهي فيها فترة ساعات العمل الحالية خلال مدة تصل إلى 7 أيام في المستقبل لا يتم ملء هذا الحقل إلا إذا كانت فترة ساعات العمل نشطة في وقت عرض الطلب.
open_now

bool

تُستخدَم لتحديد ما إذا كانت فترة ساعات العمل نشطة حاليًا. بالنسبة إلى ساعات العمل العادية وساعات العمل الحالية، يشير هذا الحقل إلى ما إذا كان المكان مفتوحًا. بالنسبة إلى ساعات العمل الثانوية وساعات العمل الثانوية الحالية، يشير هذا الحقل إلى ما إذا كانت ساعات العمل الثانوية لهذا المكان نشطة.

نقطة

تمثّل هذه السمة الفترة التي يظلّ فيها المكان في الحالة open_now.

الحقول
open

Point

تمثّل هذه السمة الوقت الذي يبدأ فيه المكان بفتح أبوابه.
close

Point

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

نقطة

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

الحقول
date

Date

تمثّل هذه السمة التاريخ حسب المنطقة الزمنية المحلية للمكان.
truncated

bool

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

int32

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

int32

الساعة بتنسيق 24 ساعة تتراوح من 0 إلى 23.
minute

int32

الدقيقة تتراوح من 0 إلى 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) هو مرجع للموقع الجغرافي يتضمّن صيغتين: رمز عالمي يحدّد مستطيلاً يبلغ حجمه 14 مترًا × 14 مترًا (1/8000 من الدرجة) أو أصغر، ورمز مركّب يحلّ محلّ البادئة مع مرجع للموقع الجغرافي.

الحقول
global_code

string

الرمز العالمي (الكامل) للمكان، مثل "9FWM33GV+HQ"، الذي يمثّل منطقة تبلغ مساحتها 1/8000 درجة في 1/8000 درجة (أي حوالي 14 مترًا في 14 مترًا).
compound_code

string

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

ReviewSummary

ملخّص من إنشاء الذكاء الاصطناعي للمكان باستخدام مراجعات المستخدمين

الحقول
text

LocalizedText

ملخّص مراجعات المستخدمين
flag_content_uri

string

رابط يمكن للمستخدمين من خلاله الإبلاغ عن مشكلة في الملخّص
disclosure_text

LocalizedText

رسالة الإفصاح عن استخدام الذكاء الاصطناعي "تم التلخيص باستخدام Gemini" (والصيغ المتوافقة مع اللغة المحلية) سيتم عرضها باللغة المحدّدة في الطلب إذا كانت متاحة.
reviews_uri

string

رابط لعرض مراجعات هذا المكان على "خرائط Google"

SubDestination

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

الحقول
name

string

اسم المورد الخاص بالموقع الفرعي
id

string

معرّف المكان الخاص بالوجهة الفرعية.

خط متعدد

خطوط متعدّدة لمسار لا تتوافق إلا مع خطوط متعددة الأضلاع مشفّرة، ويمكن تمريرها كسلسلة وتتضمّن ضغطًا مع الحد الأدنى من فقدان البيانات. هذا هو الناتج التلقائي لواجهة Routes API.

الحقول
حقل الدمج polyline_type تضم هذه السمة نوع الخط المتعدد. يكون الناتج التلقائي لواجهة Routes API هو encoded_polyline. يمكن أن تكون polyline_type إحدى القيم التالية فقط:
encoded_polyline

string

خط متعدّد الأضلاع مشفّر، كما تعرضه Routes API تلقائيًا اطّلِع على أداتَي الترميز وفك الترميز.

PriceLevel

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

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

PriceRange

نطاق الأسعار المرتبط بمكان. يمكن عدم ضبط end_price، ما يشير إلى نطاق بدون حدّ أعلى (مثل "أكثر من 100 دولار أمريكي").

الحقول
start_price

Money

تمثّل هذه السمة الحد الأدنى لنطاق السعر (شاملةً). يجب أن يكون السعر مساويًا لهذا المبلغ أو أعلى منه.
end_price

Money

النهاية العليا لنطاق السعر (غير مشمولة). يجب أن يكون السعر أقل من هذا المبلغ.

مراجعة

معلومات عن مراجعة مكان

الحقول
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

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

string

رابط يمكن للمستخدمين من خلاله الإبلاغ عن مشكلة في المراجعة
google_maps_uri

string

رابط لعرض المراجعة على "خرائط Google"
visit_date

Date

تمثّل هذه السمة تاريخ زيارة كاتب المراجعة للمكان. يتم اقتطاع هذا الحقل إلى الشهر.

RouteModifiers

تتضمّن مجموعة من الشروط الاختيارية التي يجب استيفاؤها عند احتساب المسارات.

الحقول
avoid_tolls

bool

اختياريّ. عند ضبطها على "صحيح"، تتجنّب الطرق ذات رسوم العبور حيثما كان ذلك معقولاً، مع إعطاء الأولوية للمسارات التي لا تحتوي على طرق ذات رسوم عبور. لا ينطبق هذا الإعداد سوى على DRIVE وTWO_WHEELER TravelMode.
avoid_highways

bool

اختياريّ. عند ضبطها على "صحيح"، يتم تجنُّب الطرق السريعة حيثما كان ذلك معقولاً، مع إعطاء الأولوية للمسارات التي لا تحتوي على طرق سريعة. لا ينطبق هذا الإعداد سوى على DRIVE وTWO_WHEELER TravelMode.
avoid_ferries

bool

اختياريّ. عند ضبطها على "صحيح"، يتم تجنُّب العبّارات حيثما كان ذلك معقولاً، مع إعطاء الأولوية للمسارات التي لا تحتوي على عبّارات. لا ينطبق هذا الإعداد سوى على DRIVE وTWO_WHEELER TravelMode.
avoid_indoor

bool

اختياريّ. عند ضبطها على "صحيح"، يتم تجنُّب التنقّل في الأماكن المغلقة حيثما كان ذلك معقولاً، مع إعطاء الأولوية للمسارات التي لا تتضمّن التنقّل في الأماكن المغلقة. ينطبق هذا الإجراء على WALK TravelMode فقط.

RoutingParameters

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

الحقول
origin

LatLng

اختياريّ. أصل توجيه صريح يتجاوز الأصل المحدّد في الخط المتعدد الأضلاع. يتم تلقائيًا استخدام مصدر الخط المتعدد المنكسر.
travel_mode

TravelMode

اختياريّ. وسيلة النقل
route_modifiers

RouteModifiers

اختياريّ. معدِّلات المسار
routing_preference

RoutingPreference

اختياريّ. تحدّد هذه السمة كيفية احتساب ملخّصات التوجيه. يحاول الخادم استخدام إعدادات التوجيه المفضّلة المحدّدة لحساب المسار. لا يتوفّر خيار "توجيه حسب حركة المرور" إلا في DRIVE أو TWO_WHEELER travelMode.

RoutingPreference

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

عمليات التعداد
ROUTING_PREFERENCE_UNSPECIFIED لم يتم تحديد أي إعدادات مفضّلة للتوجيه. القيمة التلقائية هي TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE تحسب هذه الطريقة المسارات بدون أخذ ظروف حركة المرور في الوقت الفعلي في الاعتبار. مناسبة عندما لا تكون أحوال حركة المرور مهمة أو لا تنطبق. يؤدي استخدام هذه القيمة إلى تحقيق أقل وقت استجابة. ملاحظة: بالنسبة إلى TravelMode DRIVE وTWO_WHEELER، يستند المسار والمدة المحدّدان إلى شبكة الطرق ومتوسط حالة حركة المرور المستقلة عن الوقت، وليس إلى حالة الطرق الحالية. نتيجةً لذلك، قد تتضمّن المسارات طرقًا مغلقة مؤقتًا. قد تختلف نتائج طلب معيّن بمرور الوقت بسبب التغييرات في شبكة الطرق، وتعديل متوسط أحوال حركة المرور، وطبيعة الخدمة الموزّعة. قد تختلف النتائج أيضًا بين المسارات المتكافئة تقريبًا في أي وقت أو تكرار.
TRAFFIC_AWARE تحسب المسارات مع أخذ ظروف حركة المرور في الوقت الفعلي في الاعتبار. على عكس TRAFFIC_AWARE_OPTIMAL، يتم تطبيق بعض التحسينات لتقليل وقت الاستجابة بشكل كبير.
TRAFFIC_AWARE_OPTIMAL تحسب هذه الطريقة المسارات مع أخذ ظروف حركة المرور في الوقت الفعلي في الاعتبار، بدون تطبيق معظم تحسينات الأداء. يؤدي استخدام هذه القيمة إلى حدوث أعلى وقت استجابة.

RoutingSummary

تمثّل هذه السمة المدة والمسافة من نقطة انطلاق التوجيه إلى مكان في الرد، بالإضافة إلى جزء ثانٍ من ذلك المكان إلى الوجهة، إذا طُلب ذلك. ملاحظة: تؤدي إضافة routingSummaries في قناع الحقل بدون تضمين المَعلمة routingParameters.origin أو المَعلمة searchAlongRouteParameters.polyline.encodedPolyline في الطلب إلى حدوث خطأ.

الحقول
legs[]

Leg

أجزاء الرحلة

عند حساب مدة التنقل والمسافة من نقطة انطلاق محدّدة، يحتوي legs على جزء واحد يتضمّن المدة والمسافة من نقطة الانطلاق إلى الوجهة. عند إجراء بحث على طول المسار، يتضمّن legs جزأين: جزء من نقطة الانطلاق إلى المكان، وجزء من المكان إلى الوجهة.
directions_uri

string

رابط لعرض الاتجاهات على "خرائط Google" باستخدام نقاط الطريق من ملخّص التوجيه المقدَّم ليس من المضمون أن يكون المسار الذي تم إنشاؤه باستخدام هذا الرابط هو نفسه المسار المستخدَم لإنشاء ملخّص التوجيه. يستخدم الرابط المعلومات المقدَّمة في الطلب، من الحقول بما في ذلك routingParameters وsearchAlongRouteParameters عند الاقتضاء، لإنشاء رابط الاتجاهات.

ساق

المرحلة هي جزء واحد من رحلة من موقع جغرافي إلى آخر.

الحقول
duration

Duration

الوقت المستغرَق لإكمال جزء الرحلة هذا
distance_meters

int32

تمثّل هذه السمة مسافة جزء الرحلة هذا.

SearchNearbyRequest

طلب نموذج أولي لميزة "البحث عن أماكن قريبة"

الحقول
language_code

string

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

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

string

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

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

يُرجى العِلم أنّ رموز المناطق المكوّنة من 3 أرقام غير متاحة حاليًا.
included_types[]

string

نوع المكان المُضمَّن (مثل "restaurant" أو "gas_station") من https://developers.google.com/maps/documentation/places/web-service/place-types

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

في حال وجود أي أنواع متعارضة، أي أنّ نوعًا يظهر في كلّ من included_types وexcluded_types، سيتم عرض الخطأ INVALID_ARGUMENT.

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

string

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

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

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

في حال وجود أي أنواع متعارضة، أي أنّ نوعًا يظهر في كلّ من included_types وexcluded_types، سيتم عرض الخطأ INVALID_ARGUMENT.

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

string

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

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

في حال وجود أي أنواع أساسية متعارضة، أي إذا ظهر نوع في كلّ من included_primary_types وexcluded_primary_types، سيتم عرض الخطأ INVALID_ARGUMENT.

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

string

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

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

في حال وجود أي أنواع أساسية متعارضة، أي إذا ظهر نوع في كلّ من included_primary_types وexcluded_primary_types، سيتم عرض الخطأ INVALID_ARGUMENT.

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

int32

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

LocationRestriction

مطلوب. تمثّل هذه السمة المنطقة المطلوب البحث فيها.
rank_preference

RankPreference

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

RoutingParameters

اختياريّ. المَعلمات التي تؤثّر في التوجيه إلى نتائج البحث

LocationRestriction

تمثّل هذه السمة المنطقة المطلوب البحث فيها.

الحقول

حقل الدمج type

يمكن أن تكون type إحدى القيم التالية فقط:
circle

Circle

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

RankPreference

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

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

SearchNearbyResponse

نموذج الاستجابة لطلب البحث في الجوار

الحقول
places[]

Place

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

RoutingSummary

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

SearchTextRequest

طلب proto لـ SearchText

الحقول
text_query

string

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

string

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

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

string

رمز Unicode للبلد/المنطقة (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

يُستخدَم هذا الفلتر لحصر البحث على الأماكن المفتوحة حاليًا. القيمة التلقائية هي "خطأ".
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. ستعرض القيم السالبة الخطأ INVALID_ARGUMENT.

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

int32

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

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

string

اختياريّ. رمز مميّز للصفحة تم استلامه من طلب TextSearch سابق. قدِّم هذه السلسلة لاسترداد الصفحة التالية.

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

PriceLevel

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

bool

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

LocationBias

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

LocationRestriction

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

EVOptions

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

RoutingParameters

اختياريّ. مَعلمات إضافية لتوجيه المستخدم إلى النتائج.
search_along_route_parameters

SearchAlongRouteParameters

اختياريّ. نموذج أولي للمَعلمات الإضافية للبحث على طول مسار
include_pure_service_area_businesses

bool

اختياريّ. أدرِج الأنشطة التجارية القاصرة على منطقة الخدمة إذا تم ضبط الحقل على "صحيح". المؤسسة ضمن منطقة الخدمة هي مؤسسة تقدّم خدماتها من خلال الانتقال إلى المواقع الجغرافية للعملاء أو توصيل الخدمة إليهم مباشرةً، ولكنّها لا تقدّم خدماتها لهم في عنوانها. على سبيل المثال، خدمات التنظيف أو السباكة ولا تتضمّن هذه الأنشطة التجارية عنوانًا أو موقعًا جغرافيًا على "خرائط Google". لن تعرض خدمة "أماكن" حقولاً تتضمّن location وplus_code وغيرها من الحقول ذات الصلة بالموقع الجغرافي لهذه الأنشطة التجارية.

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 بالنسبة إلى طلب بحث فئوي مثل "مطاعم في مدينة الرياض"، تكون "الملاءمة" هي الإعداد التلقائي. بالنسبة إلى طلبات البحث غير الفئوية، مثل "ماونتن فيو، كاليفورنيا"، ننصحك بعدم ضبط rankPreference.
DISTANCE ترتيب النتائج حسب المسافة
RELEVANCE ترتيب النتائج حسب مدى صلتها بموضوع البحث يتم تحديد ترتيب الفرز حسب حزمة الترتيب العادية.

SearchAlongRouteParameters

تحدّد هذه السمة خطًا متعدد الأضلاع تم حسابه مسبقًا من Routes API، ويحدّد المسار المطلوب البحث عنه. يشبه البحث على طول مسار استخدام خيار الطلب locationBias أو locationRestriction لتحديد نتائج البحث. في المقابل، يتيح لك هذا الخيار تحديد مسار رحلة لتوجيه نتائج البحث، بينما يتيح لك الخياران locationBias وlocationRestriction تحديد منطقة لتوجيه نتائج البحث.

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

الحقول
polyline

Polyline

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

SearchTextResponse

نموذج الردّ على SearchText

الحقول
places[]

Place

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

RoutingSummary

قائمة بملخّصات التوجيه، حيث يرتبط كل إدخال بالمكان المقابل له في الفهرس نفسه في الحقل places. إذا لم يتوفّر ملخّص التوجيه لأحد الأماكن، سيتضمّن إدخالاً فارغًا. ستتضمّن هذه القائمة عددًا من الإدخالات يساوي عدد الأماكن في القائمة إذا طُلب ذلك.
contextual_contents[]

ContextualContent

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

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

string

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

string

يتيح الرابط للمستخدم البحث باستخدام طلب البحث النصي نفسه المحدّد في الطلب على "خرائط Google".

TravelMode

خيارات وضع السفر تتطابق هذه الخيارات مع الميزات التي توفّرها Routes API.

عمليات التعداد
TRAVEL_MODE_UNSPECIFIED لم يتم تحديد وضع السفر. القيمة التلقائية هي DRIVE.
DRIVE السفر بسيارة ركاب
BICYCLE السفر بالدراجة لا يمكن استخدامها مع search_along_route_parameters.
WALK التنقّل سيرًا على الأقدام لا يمكن استخدامها مع search_along_route_parameters.
TWO_WHEELER المركبات ذات العجلتين والمزوّدة بمحرّك من جميع الأنواع، مثل الدراجات البخارية والدراجات النارية يُرجى العلم أنّ هذا النوع يختلف عن BICYCLE وسيلة النقل التي تعمل بالطاقة البشرية. لا يمكن استخدامها مع search_along_route_parameters. تتوفّر هذه الميزة فقط في البلدان المُدرَجة في البلدان والمناطق التي تتوفّر فيها المركبات ذات العجلتين.