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)

لعرض التوقّعات للمدخلات المحدّدة

نطاقات التفويض

يجب توفير نطاق 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

عنوان URL لصورة الملف الشخصي لمؤلف 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

اختياريّ. نوع المكان الأساسي المُدرَج (مثل "مطعم" أو "محطة_غاز") في أنواع الأماكن (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.

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

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

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

bool

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

LocationBias

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

الحقول

حقل الربط type

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

Viewport

إطار عرض محدّد من خلال زاوية شمال شرقية وجنوب غربية
circle

Circle

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

LocationRestriction

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

الحقول

حقل الربط type

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

Viewport

إطار عرض محدّد من خلال زاوية شمال شرقية وجنوب غربية
circle

Circle

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

AutocompletePlacesResponse

ملف proto للردّ في AutocompletePlaces

الحقول
suggestions[]

Suggestion

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

اقتراح

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

الحقول

حقل الربط kind

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

PlacePrediction

توقّع لمكان
query_prediction

QueryPrediction

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

FormattableText

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

الحقول
text

string

نص يمكن استخدامه كما هو أو تنسيقه باستخدام matches
matches[]

StringRange

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

هذه القيم هي Offsets لحرف 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

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

دائرة

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

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

النص الذي تم تمييزه من خلال التبرير هذه مجموعة فرعية من المراجعة نفسها. يتم وضع علامة على الكلمة المحدّدة التي سيتم تمييزها باستخدام 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 موصل J1772 من النوع 1
EV_CONNECTOR_TYPE_TYPE_2 موصل من النوع 2 وفقًا لمعيار IEC 62196 يُشار إليها غالبًا باسم MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO موصّل من النوع CHAdeMO
EV_CONNECTOR_TYPE_CCS_COMBO_1 نظام الشحن المدمج (التيار المتناوب والمباشر) استنادًا إلى SAE موصل J-1772 من النوع 1
EV_CONNECTOR_TYPE_CCS_COMBO_2 نظام الشحن المدمج (التيار المتناوب والمباشر) استنادًا إلى موصّل Type-2 Mennekes
EV_CONNECTOR_TYPE_TESLA موصل TESLA العام يُستخدم هذا المعيار في أمريكا الشمالية، ولكن قد لا يكون معتمدًا في أجزاء أخرى من العالم (مثل 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 الإصدار 92 من حزمة الخدمة
SP95 SP 95
SP95_E10 ‫SP95 E10
SP98 SP 98.
SP99 SP 99.
SP100 ‫SP 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.

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

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

string

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

string

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

PhotoMedia

ملف وسائط صورة من Places API

الحقول
name

string

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

string

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

مكان

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

الحقول
name

string

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

string

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

LocalizedText

الاسم المترجَم للمكان، وهو مناسب ليكون وصفًا قصيرًا يمكن لشخص عادي قراءته على سبيل المثال، "Google Sydney" و"Starbucks" و"Pyrmont" وما إلى ذلك.
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[]: - قد تحتوي صفيف مكونات العنوان على مكونات أكثر من 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][google.maps.places.v1.Place.OpeningHours.Period.open] تحتوي على [day][Point.day] بالقيمة 0 و[hour][Point.hour] بالقيمة 0 و[minute][Point.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

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

OpeningHours

يحتوي على صفيف من الإدخالات للحصول على معلومات عن ساعات العمل الثانوية العادية للنشاط التجاري. تختلف ساعات العمل الثانوية عن ساعات العمل الرئيسية للنشاط التجاري. على سبيل المثال، يمكن أن يحدّد مطعم ساعات العمل في خدمة "الاستلام من السيارة" أو ساعات العمل في خدمة التوصيل كساعات العمل الثانوية. يملؤ هذا الحقل الحقل الفرعي type، الذي يستمد بياناته من قائمة محدّدة مسبقًا بأنواع ساعات العمل (مثل 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 للحصول على مزيد من التفاصيل.

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

ContainingPlace

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

AddressDescriptor

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

PriceRange

نطاق الأسعار المرتبط بمكان
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

AreaSummary

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

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

الحقول
content_blocks[]

ContentBlock

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

string

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

تحديد المصدر

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

الحقول
provider

string

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

string

عنوان URL لمزوّد بيانات المكان

BusinessStatus

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

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

ContainingPlace

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

الحقول
name

string

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

string

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

GenerativeSummary

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

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

الحقول
overview

LocalizedText

نظرة عامة على المكان
overview_flag_content_uri

string

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

LocalizedText

الوصف التفصيلي للمكان
description_flag_content_uri

string

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

References

المراجع المستخدَمة لإنشاء الوصف الموجز

OpeningHours

معلومات حول ساعات عمل المكان

الحقول
periods[]

Period

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

string

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

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

الحدّ الأعلى لنطاق السعر (حصري). يجب أن يكون السعر أقل من هذا المبلغ.

المراجع

ميزة تجريبية: يُرجى الاطّلاع على 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

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

string

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

string

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

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

طلب ملف proto لميزة "البحث عن مكان قريب"

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

نوع المكان المُدرَج (مثل "مطعم" أو "محطة_بنزين") من 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

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

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

إذا قدّم العميل كلاً من 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

تم استبعاد نوع المكان الأساسي (مثل "مطعم" أو "محطة_غاز") من 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. سيتم استخدام ترتيب حسب مدى الرواج تلقائيًا.
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

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

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

PriceLevel

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

bool

تُستخدَم لضبط فلترة صارمة للنوع في included_type. في حال ضبطها على "صحيح"، سيتم عرض النتائج من النوع نفسه فقط. القيمة التلقائية هي false.
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

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

قائمة بالمحتوى السياقي الذي يرتبط كل إدخال فيه بالموقع المقابل له في الفهرس نفسه في حقل places يُفضّل استخدام المحتوى ذي الصلة بالموضوع 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. تتوفّر هذه الميزة فقط في البلدان المدرَجة في البلدان والمناطق التي تتوفّر فيها المركبات ذات العجلتين.