Package google.maps.places.v1

الفهرس

Places (واجهة)
AddressDescriptor (رسالة)
AddressDescriptor.Area (رسالة)
AddressDescriptor.Area.Containment (تعداد)
AddressDescriptor.Landmark (رسالة)
AddressDescriptor.Landmark.SpatialRelationship (تعداد)
AuthorAttribution (رسالة)
AutocompletePlacesRequest (رسالة)
AutocompletePlacesRequest.LocationBias (رسالة)
AutocompletePlacesRequest.LocationRestriction (رسالة)
AutocompletePlacesResponse (رسالة)
AutocompletePlacesResponse.Suggestion (رسالة)
AutocompletePlacesResponse.Suggestion.FormattableText (رسالة)
AutocompletePlacesResponse.Suggestion.PlacePrediction (رسالة)
AutocompletePlacesResponse.Suggestion.QueryPrediction (رسالة)
AutocompletePlacesResponse.Suggestion.StringRange (رسالة)
AutocompletePlacesResponse.Suggestion.StructuredFormat (رسالة)
Circle (رسالة)
ContentBlock (رسالة)
ContextualContent (رسالة)
ContextualContent.Justification (رسالة)
ContextualContent.Justification.BusinessAvailabilityAttributesJustification (رسالة)
ContextualContent.Justification.ReviewJustification (رسالة)
ContextualContent.Justification.ReviewJustification.HighlightedText (رسالة)
ContextualContent.Justification.ReviewJustification.HighlightedText.HighlightedTextRange (رسالة)
EVChargeOptions (رسالة)
EVChargeOptions.ConnectorAggregation (رسالة)
EVConnectorType (تعداد)
FuelOptions (رسالة)
FuelOptions.FuelPrice (رسالة)
FuelOptions.FuelPrice.FuelType (تعداد)
GetPhotoMediaRequest (رسالة)
GetPlaceRequest (رسالة)
Photo (رسالة)
PhotoMedia (رسالة)
Place (رسالة)
Place.AccessibilityOptions (رسالة)
Place.AddressComponent (رسالة)
Place.Attribution (رسالة)
Place.BusinessStatus (تعداد)
Place.ConsumerAlert (رسالة)
Place.ConsumerAlert.Details (رسالة)
Place.ConsumerAlert.Details.Link (رسالة)
Place.ContainingPlace (رسالة)
Place.EvChargeAmenitySummary (رسالة)
Place.GenerativeSummary (رسالة)
Place.GoogleMapsLinks (رسالة)
Place.NeighborhoodSummary (رسالة)
Place.OpeningHours (رسالة)
Place.OpeningHours.Period (رسالة)
Place.OpeningHours.Period.Point (رسالة)
Place.OpeningHours.SecondaryHoursType (تعداد)
Place.OpeningHours.SpecialDay (رسالة)
Place.ParkingOptions (رسالة)
Place.PaymentOptions (رسالة)
Place.PlusCode (رسالة)
Place.ReviewSummary (رسالة)
Place.SubDestination (رسالة)
Polyline (رسالة)
PriceLevel (تعداد)
PriceRange (رسالة)
Review (رسالة)
RouteModifiers (رسالة)
RoutingParameters (رسالة)
RoutingPreference (تعداد)
RoutingSummary (رسالة)
RoutingSummary.Leg (رسالة)
SearchNearbyRequest (رسالة)
SearchNearbyRequest.LocationRestriction (رسالة)
SearchNearbyRequest.RankPreference (تعداد)
SearchNearbyResponse (رسالة)
SearchTextRequest (رسالة)
SearchTextRequest.EVOptions (رسالة)
SearchTextRequest.LocationBias (رسالة)
SearchTextRequest.LocationRestriction (رسالة)
SearchTextRequest.RankPreference (تعداد)
SearchTextRequest.SearchAlongRouteParameters (رسالة)
SearchTextResponse (رسالة)
TravelMode (تعداد)

أماكن

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

AutocompletePlaces

AutocompletePlaces
`rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)` تعرض هذه الطريقة التوقعات الخاصة بالمدخلات المحدّدة. نطاقات الأذونات يجب توفير نطاق OAuth التالي: `https://www.googleapis.com/auth/cloud-platform`

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

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

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

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

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

GetPhotoMedia

GetPhotoMedia
`rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)` الحصول على وسائط صورة باستخدام سلسلة مرجعية للصورة نطاقات الأذونات يجب توفير نطاق OAuth التالي: `https://www.googleapis.com/auth/cloud-platform`

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

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

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

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

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

GetPlace

GetPlace
`rpc GetPlace(GetPlaceRequest) returns (Place)` يمكنك الحصول على تفاصيل عن مكان استنادًا إلى اسم المورد الخاص به، وهو سلسلة بالتنسيق `places/{place_id}`. نطاقات الأذونات يجب توفير نطاق OAuth التالي: `https://www.googleapis.com/auth/cloud-platform`

rpc GetPlace(GetPlaceRequest) returns (Place)

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

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

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

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

SearchNearby

SearchNearby
`rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)` البحث عن أماكن بالقرب من مواقع جغرافية نطاقات الأذونات يجب توفير نطاق OAuth التالي: `https://www.googleapis.com/auth/cloud-platform`

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

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

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

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

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

SearchText

SearchText
`rpc SearchText(SearchTextRequest) returns (SearchTextResponse)` البحث عن أماكن استنادًا إلى طلب بحث نصي نطاقات الأذونات يجب توفير نطاق OAuth التالي: `https://www.googleapis.com/auth/cloud-platform`

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

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

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

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

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

AddressDescriptor

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

الحقول

الحقول
`landmarks[]`	`Landmark` قائمة مرتبة حسب الأهمية بالمعالم القريبة يتم ترتيب المعالم الأكثر شهرة والأقرب إليك أولاً.
`areas[]`	`Area` قائمة مرتبة حسب الأهمية بالمناطق التي تحتوي على الموقع الجغرافي أو المجاورة له يتم ترتيب المناطق الأكثر وضوحًا ودقةً أولاً.

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`.

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` أو إعادة استخدام رمز مميّز للجلسة، سيتم تحصيل رسوم الجلسة كما لو لم يتم تقديم رمز مميّز للجلسة (سيتم تحصيل رسوم كل طلب على حدة). ننصحك باتّباع الإرشادات التالية: استخدِم الرموز المميزة للجلسات لجميع طلبات الإكمال التلقائي للأماكن. إنشاء رمز مميّز جديد لكل جلسة ننصح باستخدام معرّف فريد عالميًا من الإصدار 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` دائرة محدّدة بنقطة مركزية ونصف قطر

حقل الدمج type

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

rectangle

Viewport

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

circle

Circle

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

LocationRestriction

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

الحقول

الحقول
حقل الدمج `type` يمكن أن تكون `type` إحدى القيم التالية فقط:
`rectangle`	`Viewport` نافذة عرض محدّدة بواسطة ركن شمالي شرقي وركن جنوبي غربي.
`circle`	`Circle` دائرة محدّدة بنقطة مركزية ونصف قطر

حقل الدمج type

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

rectangle

Viewport

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

circle

Circle

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

AutocompletePlacesResponse

بروتوكول الردّ الخاص بـ AutocompletePlaces.

الحقول

الحقول
`suggestions[]`	`Suggestion` تحتوي على قائمة بالاقتراحات، ويتم ترتيبها ترتيبًا تنازليًا حسب الصلة بالموضوع.

suggestions[]

Suggestion

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

اقتراح

تمثّل هذه السمة نتيجة اقتراح للإكمال التلقائي.

الحقول

الحقول
حقل الدمج `kind` يمكن أن تكون `kind` إحدى القيم التالية فقط:
`place_prediction`	`PlacePrediction` توقّع لمكان
`query_prediction`	`QueryPrediction` توقّع لطلب بحث

حقل الدمج kind

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

place_prediction

PlacePrediction

توقّع لمكان

query_prediction

QueryPrediction

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

FormattableText

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

الحقول

الحقول
`text`	`string` نص يمكن استخدامه كما هو أو تنسيقه باستخدام `matches`
`matches[]`	`StringRange` قائمة بنطاقات السلاسل التي تحدّد موضع تطابق طلب الإدخال في `text`. يمكن استخدام النطاقات لتنسيق أجزاء معيّنة من `text`. قد لا تكون السلاسل الفرعية مطابقة تمامًا لـ `input` إذا تم تحديد المطابقة من خلال معايير أخرى غير مطابقة السلسلة (على سبيل المثال، تصحيحات إملائية أو ترجمات صوتية). هذه القيم هي إزاحات أحرف Unicode الخاصة بـ `text`. من المضمون أن يتم ترتيب النطاقات حسب قيم الإزاحة المتزايدة.

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` أو العكس.

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 (حصري).

start_offset

int32

الإزاحة المستندة إلى الصفر لأول حرف Unicode في السلسلة (شاملة).

end_offset

int32

إزاحة مستندة إلى الصفر لآخر حرف Unicode (حصري).

StructuredFormat

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

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

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

الحقول

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

main_text

FormattableText

تمثّل هذه السمة اسم المكان أو طلب البحث.

secondary_text

FormattableText

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

دائرة

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

الحقول

الحقول
`center`	`LatLng` الحقل مطلوب. خط العرض وخط الطول في المنتصف يجب أن يكون نطاق خط العرض ضمن [-90.0, 90.0]. يجب أن يكون نطاق خط الطول ضِمن [-180.0, 180.0].
`radius`	`double` الحقل مطلوب. نصف القطر مقاسًا بالأمتار يجب أن يكون نصف القطر ضمن النطاق [0.0, 50000.0].

center

LatLng

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

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

radius

double

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

ContentBlock

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

الحقول

الحقول
`content`	`LocalizedText` المحتوى ذو الصلة بالموضوع
`referenced_places[]`	`string` قائمة بأسماء المراجع الخاصة بالأماكن المشار إليها يمكن استخدام هذا الاسم في واجهات برمجة التطبيقات الأخرى التي تقبل أسماء موارد الأماكن.

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 لمزيد من التفاصيل. مستندات إثبات ملكية المكان

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 لمزيد من التفاصيل.

حقل الدمج 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` تُستخدَم لتحديد ما إذا كان المكان يوفّر خدمة تناول الطعام في المكان.

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` المراجعة التي تم إنشاء النص المحدَّد منها

highlighted_text

HighlightedText

review

Review

المراجعة التي تم إنشاء النص المحدَّد منها

HighlightedText

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

الحقول

الحقول
`text`	`string`
`highlighted_text_ranges[]`	`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` قائمة بعمليات تجميع لوصلات شحن المركبات الكهربائية التي تحتوي على وصلات من النوع نفسه ومعدّل الشحن نفسه

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 في أمريكا الشمالية، ولكن يمكن أن يكون غير 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` آخر سعر معروف للوقود لكل نوع من أنواع الوقود المتوفرة في هذه المحطة يحتوي هذا الجدول على إدخال واحد لكل نوع من الوقود المتوفّر في المحطة. الترتيب غير مهم.

fuel_prices[]

FuelPrice

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

FuelPrice

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

الحقول

الحقول
`type`	`FuelType` تمثّل هذه السمة نوع الوقود.
`price`	`Money` تمثّل هذه السمة سعر الوقود.
`update_time`	`Timestamp` يشير هذا العنصر إلى وقت آخر تعديل لسعر الوقود.

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` أو إعادة استخدام رمز مميّز للجلسة، سيتم تحصيل رسوم الجلسة كما لو لم يتم تقديم رمز مميّز للجلسة (سيتم تحصيل رسوم كل طلب على حدة). ننصحك باتّباع الإرشادات التالية: استخدِم الرموز المميزة للجلسات لجميع طلبات الإكمال التلقائي للأماكن. إنشاء رمز مميّز جديد لكل جلسة ننصح باستخدام معرّف فريد عالميًا من الإصدار 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}/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. قد يكون النوع الأساسي مفقودًا إذا لم يكن النوع الأساسي للمكان نوعًا متوافقًا.
`google_maps_type_label`	`LocalizedText` تصنيف المكان على "خرائط Google"، مع مراعاة اللغة المستخدَمة في الطلب إذا كان ذلك منطبقًا، مثل "مطعم" أو "مقهى" أو "مطار" وما إلى ذلك. قد يختلف تصنيف المكان عن الاسم المعروض للنوع الأساسي وقد لا يكون نوعًا متاحًا في جدول أنواع الأماكن في Places API.
`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.
`google_maps_links`	`GoogleMapsLinks` روابط لتنفيذ إجراءات مختلفة على "خرائط Google"
`price_range`	`PriceRange` نطاق الأسعار المرتبط بمكان.
`review_summary`	`ReviewSummary` ملخّص من إنشاء الذكاء الاصطناعي للمكان باستخدام مراجعات المستخدمين
`ev_charge_amenity_summary`	`EvChargeAmenitySummary` ملخّص عن وسائل الراحة بالقرب من محطة شحن المركبات الكهربائية
`neighborhood_summary`	`NeighborhoodSummary` ملخّص عن نقاط الاهتمام القريبة من المكان
`consumer_alert`	`ConsumerAlert` رسالة تنبيه المستهلك للمكان عندما نرصد نشاطًا مريبًا في المراجعات يخصّ نشاطًا تجاريًا أو نرصد انتهاكًا من نشاط تجاري لسياساتنا
`moved_place`	`string` إذا كان هذا المكان مغلقًا نهائيًا وانتقل إلى مكان جديد، يحتوي هذا الحقل على اسم المورد الخاص بالمكان الجديد بالتنسيق `places/{place_id}`. إذا تم نقل هذا المكان عدة مرات، سيمثّل هذا الحقل المكان الذي تم نقله أولاً. لن تتم تعبئة هذا الحقل إذا لم يتم نقل هذا المكان.
`moved_place_id`	`string` إذا كان هذا المكان مغلقًا نهائيًا وتم نقله إلى مكان جديد، يحتوي هذا الحقل على رقم تعريف المكان الجديد. إذا تم نقل هذا المكان عدة مرات، سيمثّل هذا الحقل المكان الذي تم نقله أولاً. لن تتم تعبئة هذا الحقل إذا لم يتم نقل هذا المكان.
`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) لمزوّد بيانات المكان

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.

overview

string

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

details

Details

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

language_code

string

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

التفاصيل

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

الحقول

الحقول
`title`	`string` العنوان الذي سيظهر مع الوصف
`description`	`string` وصف رسالة تنبيه المستهلك
`about_link`	`Link` الرابط الذي سيتم عرضه مع الوصف لتقديم المزيد من المعلومات

title

string

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

description

string

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

about_link

Link

الرابط الذي سيتم عرضه مع الوصف لتقديم المزيد من المعلومات

رابط

الرابط الذي سيتم عرضه مع الوصف لتقديم المزيد من المعلومات

الحقول

الحقول
`title`	`string` عنوان الرابط الذي سيتم عرضه
`uri`	`string` تمثّل هذه السمة معرّف الموارد المنتظم (URI) للرابط.

title

string

عنوان الرابط الذي سيتم عرضه

uri

string

تمثّل هذه السمة معرّف الموارد المنتظم (URI) للرابط.

ContainingPlace

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

الحقول

الحقول
`name`	`string` اسم المورد للمكان الذي يقع فيه هذا المكان
`id`	`string` تمثّل هذه السمة رقم تعريف المكان الذي يقع فيه هذا المكان.

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" (والصيغ المتوافقة مع اللغة المحلية) سيتم عرضها باللغة المحدّدة في الطلب إذا كانت متاحة.

overview

LocalizedText

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

overview_flag_content_uri

string

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

disclosure_text

LocalizedText

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

GoogleMapsLinks

روابط لتنفيذ إجراءات مختلفة على "خرائط Google"

الحقول
`directions_uri`	`string` رابط لعرض الاتجاهات إلى المكان يتم ملء الرابط بموقع الوجهة فقط ويستخدم وضع السفر التلقائي `DRIVE`.
`place_uri`	`string` رابط لعرض هذا المكان
`write_a_review_uri`	`string` رابط لكتابة مراجعة عن هذا المكان على "خرائط Google"
`reviews_uri`	`string` رابط لعرض مراجعات هذا المكان على "خرائط Google"
`photos_uri`	`string` رابط لعرض صور هذا المكان على "خرائط Google"

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. سيتم استخدام الترتيب حسب مدى الرواج تلقائيًا.
`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

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`. تتوفّر هذه الميزة فقط في البلدان المُدرَجة في البلدان والمناطق التي تتوفّر فيها المركبات ذات العجلتين.

Package google.maps.places.v1 تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الفهرس

أماكن

AddressDescriptor

منطقة

الاحتواء

مَعلم

SpatialRelationship

AuthorAttribution

AutocompletePlacesRequest

LocationBias

LocationRestriction

AutocompletePlacesResponse

اقتراح

FormattableText

PlacePrediction

QueryPrediction

StringRange

StructuredFormat

دائرة

ContentBlock

ContextualContent

التبرير

BusinessAvailabilityAttributesJustification

ReviewJustification

HighlightedText

HighlightedTextRange

EVChargeOptions

ConnectorAggregation

EVConnectorType

FuelOptions

FuelPrice

FuelType

GetPhotoMediaRequest

GetPlaceRequest

صورة

PhotoMedia

مكان

AccessibilityOptions

AddressComponent

تحديد المصدر

BusinessStatus

ConsumerAlert

التفاصيل

رابط

ContainingPlace

EvChargeAmenitySummary

GenerativeSummary

GoogleMapsLinks

NeighborhoodSummary

OpeningHours

نقطة

نقطة

SecondaryHoursType

SpecialDay

ParkingOptions

PaymentOptions

PlusCode

ReviewSummary

SubDestination

خط متعدد

PriceLevel

PriceRange

مراجعة

RouteModifiers

RoutingParameters

RoutingPreference

RoutingSummary

الرجل

SearchNearbyRequest

LocationRestriction

RankPreference

SearchNearbyResponse

SearchTextRequest

EVOptions

LocationBias

LocationRestriction

RankPreference

SearchAlongRouteParameters

SearchTextResponse

Package google.maps.places.v1