Package google.maps.locationselection.v1beta

الفهرس

LocationSelectionBeta

خدمة البحث عن الأماكن المجاورة ونقاط الاستلام والتسليم المرتبطة

FindNearbyPlaces

rpc FindNearbyPlaces(FindNearbyPlacesRequest) returns (FindNearbyPlacesResponse)

العثور على الأماكن المجاورة لموقع معين.
FindPickupPointsForLocation

rpc FindPickupPointsForLocation(FindPickupPointsForLocationRequest) returns (FindPickupPointsForLocationResponse)

العثور على نقاط استلام لمكان معيّن
FindPickupPointsForPlace

rpc FindPickupPointsForPlace(FindPickupPointsForPlaceRequest) returns (FindPickupPointsForPlaceResponse)

ابحث عن نقاط الاستلام لمكان معيّن.

العنوان

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

الحقول
formatted_address

FormattedAddress

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

AddressComponent

قائمة بمكونات العنوان

AddressComponent

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

الحقول
component_text

string

اسم هذا المكوّن الذي يصف جزءًا من العنوان وتشمل الأمثلة "كاليفورنيا" و"Amphitheatre Parkway".
component_text_short_form

string

النص المختصر للمكوّن وتشمل الأمثلة "CA" لكاليفورنيا و"US" للولايات المتحدة.
types[]

string

أنواع هذا المكوّن التي تصف جزءًا من العنوان للحصول على قائمة بالأنواع المتوافقة، يُرجى الاطّلاع على https://developers.google.com/places/web-service/supported_types#table2.

مُجمّع

مركب مرتبط بمكان

الحقول
type

CompoundType

نوع المركب
geometry

Geometry

الشكل الهندسي المرتبط بالمركب
entrances[]

Entrance

قائمة بالمداخل المرتبطة بالمجمع

CompoundTypeEnums

أنواع المركبات

CompoundType

قيمة النوع المركّب.

عمليات التعداد
COMPOUND_TYPE_UNSPECIFIED نوع المركب غير معروف.
SECTION قسم "المُركّب" https://support.google.com/mapskb/answer/7054299
BUILDING مبنى مجمع. https://support.google.com/mapskb/answer/7013011
GROUNDS أرض مجمّع. https://support.google.com/mapskb/answer/7046859

مَدخل

مدخل مكان

الحقول
location

LatLng

الموقع الجغرافي للمدخل

FindNearbyPlacesRequest

رسالة طلب العثور على الأماكن المجاورة

الحقول
localization_preferences

LocalizationPreferences

مطلوب. التفضيلات المستخدمة لترجمة النصوص ردًا على ذلك، مثل الاسم والعنوان
search_location

LatLng

مطلوب. الموقع الجغرافي الذي يجب العثور فيه على الأماكن
max_results

int32

مطلوب. الحدّ الأقصى لعدد النتائج المطلوب عرضها يجب أن تكون أكبر من 0.
wifi_access_points[]

WiFiAccessPoint

نقاط وصول Wi-Fi حول الموقع الجغرافي للطلب تُستخدَم لتقديم نتائج بحث ذات جودة أعلى.

FindNearbyPlacesResponse

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

الحقول
place_results[]

PlaceResult

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

FindPickupPointsForLocationRequest

رسالة طلب FindPickupPointsForLocation

الحقول
localization_preferences

LocalizationPreferences

مطلوب. التفضيلات المستخدمة لترجمة النصوص ردًا على ذلك، مثل الاسم والعنوان
search_location

LatLng

مطلوب. الموقع الجغرافي المراد استخدامه للبحث عن نقاط الاستلام وحساب المسافات والأوقات المقدَّرة للوصول إلى نقاط الاستلام
order_by

PickupPointOrder

مطلوب. الترتيب الذي يتم استخدامه عند عرض النتائج.
destination

LatLng

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

int32

مطلوب. الحدّ الأقصى لعدد النتائج التي سيتم عرضها يجب أن تكون القيمة أكبر من 0.
travel_modes[]

TravelMode

مطلوب. يتم فقط عرض نقاط الاستلام التي تسمح باستخدام وسيلة واحدة على الأقل من وسائل النقل المحدّدة. وسائل النقل المتوافقة: DRIVING وTWO_WHEELER يجب تحديد وضع واحد على الأقل.
compute_walking_eta

bool

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

bool

إذا كانت القيمة صحيحة وتم تحديد الوجهة، يتم احتساب الوقت المقدَّر للوصول بالسيارة من نقطة الاستلام إلى الوجهة.
wifi_access_points[]

WiFiAccessPoint

نقاط وصول Wi-Fi حول موقع البحث تُستخدَم لتقديم نتائج بحث ذات جودة أعلى.

FindPickupPointsForLocationResponse

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

الحقول
place_pickup_point_results[]

PlacePickupPointResult

نقاط الاستلام القريبة مع رقم تعريف المكان المرتبط بها يتم ترتيب النتائج في هذه القائمة وفقًا للمعايير الواردة في الطلب. قد يتجاوز عدد النتائج في "place_pickup_point_results" عدد النتائج في "place_results".
place_results[]

PlaceResult

تفاصيل عن الأماكن المرتبطة بنقاط الاستلام القريبة لا يتم ترتيب النتائج في هذه القائمة.

FindPickupPointsForPlaceRequest

رسالة طلب FindPickupPointsForPlace

الحقول
place_id

string

مطلوب. رقم تعريف المكان الذي يتم طلب نقاط الاستلام له.
localization_preferences

LocalizationPreferences

مطلوب. الإعدادات المفضّلة المستخدَمة لترجُم النصوص في الردود، مثل الاسم والعنوان
search_location

LatLng

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

PickupPointOrder

مطلوب. ترتيب البيانات المراد استخدامه عند عرض النتائج
destination

LatLng

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

int32

مطلوب. الحدّ الأقصى لعدد النتائج التي سيتم عرضها يجب أن تكون القيمة أكبر من 0.
travel_modes[]

TravelMode

مطلوب. يتم فقط عرض نقاط الاستلام التي تسمح باستخدام وسيلة واحدة على الأقل من وسائل النقل المحدّدة. وسائل النقل المتوافقة: DRIVING وTWO_WHEELER يجب تحديد وضع واحد على الأقل.
compute_walking_eta

bool

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

bool

إذا كانت القيمة صحيحة وتم تحديد الوجهة، يتم احتساب الوقت المقدَّر للوصول بالسيارة من نقطة الاستلام إلى الوجهة.

FindPickupPointsForPlaceResponse

العثور على نقاط استلام لرسالة الردّ بشأن مكان

الحقول
pickup_point_results[]

PickupPointResult

نقاط الاستلام التي تتطابق مع معايير الطلب قد يكون هذا الحقل فارغًا إذا لم تتطابق نقاط الاستلام مع معايير الطلب.
place_result

PlaceResult

المكان المرتبط برقم تعريف المكان المحدّد في الطلب

FormattedAddress

عنوان كامل يمكن لشخص عادي قراءته للكيان الذي يحتوي على هذه الرسالة

الحقول
lines[]

string

خطوط النص التي تصف العنوان يجب أن يتوفّر سطر واحد على الأقل.

هندسة

هندسة مكان معيّن

الحقول
location

LatLng

النقطة المركزية للكيان الذي يحتوي على هذه الرسالة.
viewport

Viewport

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

Struct

تُحدِّد مضلّعًا باستخدام تنسيق المضلّع GeoJSON.

LocalizationPreferences

عنوان كامل ومقروء للجهة التي تحتوي على هذه الرسالة

الحقول
language_code

string

مطلوب. تشير هذه السمة إلى علامة اللغة BCP-47 المستخدَمة لترجمة النصوص. تشمل أمثلة علامات اللغة "en-US" و"hi-IN" و"fr-CA" وما إلى ذلك.
region_code

string

مطلوب. رمز البلد أو المنطقة بترميز Unicode (CLDR) للموقع الجغرافي الذي ينبع منه الطلب، مثل "US" و"419"

لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#unicode_region_subtag.

PickupPoint

تفاصيل حول نقطة الاستلام أو الإرجاع

الحقول
id

string

معرّف فريد لنقطة الاستلام يجب أن يكون متوفّرًا.
display_name

string

اسم قصير وسهل القراءة لنقطة الاستلام مترجمة حسب التفضيل المقدَّم في الطلب.
address

Address

عنوان نقطة الاستلام
description

string

وصف أطول لنقطة الاستلام، قد يتضمّن كيفية الوصول إلى الموقع الجغرافي
location

LatLng

تمثّل هذه السمة موقع نقطة الاستلام، أي المكان الذي يلتقي فيه الراكب أو المستلِم بالسائق. يجب أن يكون متوفّرًا.

PickupPointOrderEnums

مجموعة من القيم التي تحدّد ترتيب ترتيب نقاط الاستلام المطابِقة

PickupPointOrder

قيمة ترتيب نقطة الاستلام

عمليات التعداد
PICKUP_POINT_ORDER_UNSPECIFIED لم يتم تحديد طلب نقطة الاستلام. القيمة التلقائية هي DISTANCE_FROM_ORIGIN.
DISTANCE_FROM_SEARCH_LOCATION الترتيب التصاعدي للمسافة المستقيمة من موقع البحث إلى نقطة الاستلام التي تم عرضها
WALKING_ETA_FROM_SEARCH_LOCATION الترتيب التصاعدي حسب وقت المشي للمستهلك من الموقع الجغرافي للبحث إلى نقطة الاستلام
DRIVING_ETA_FROM_PICKUP_POINT_TO_DESTINATION الترتيب التصاعدي حسب وقت الوصول بالسيارة المقدَّر من نقطة الاستلام إلى وجهة المستهلك لا يمكن استخدام هذا الوضع إلا عند ضبط الوجهة وتكون قيمة compute_driving_eta true. عند تقديم عدة طرق سفر في الطلب، يستند الترتيب إلى طريقة السفر الأولى في الطلب.

PickupPointResult

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

الحقول
pickup_point

PickupPoint

نقطة الاستلام الفعلية التي تتطابق مع الطلب
distance_meters

float

المسافة المستقيمة من نقطة الاستلام هذه إلى search_location المحدّدة في الطلب.
travel_details[]

TravelDetail

التفاصيل المرتبطة بالسفر من وإلى نقطة الاستلام هذه لكل وسيلة نقل مطلوبة

مكان

تفاصيل عن مكان معيّن

الحقول
place_id

string

رقم تعريف المكان. معرّف المكان هو نص يحدِّد مكانًا بشكلٍ فريد. https://developers.google.com/places/web-service/place-id
display_name

string

اسم المكان المترجَم مترجمة حسب التفضيل المقدَّم في الطلب.
language_code

string

رمز اللغة لحقول النصوص المرتبطة بالمكان على سبيل المثال، "الاسم" و"العنوان".
address

Address

عنوان المكان.
geometry

Geometry

هندسة المكان.
types[]

string

مجموعة من علامات النوع لهذه النتيجة على سبيل المثال، "سياسية" و"منطقة محلية". https://developers.google.com/places/web-service/supported_types
associated_compounds[]

Compound

المركبات المرتبطة بالمكان

PlacePickupPointResult

نقاط الاستلام التي تتضمّن معرّف المكان المرتبط بها

الحقول
pickup_point_result

PickupPointResult

تفاصيل حول نقطة الاستلام يجب أن يكون متوفّرًا.
associated_place_id

string

معرّف المكان المرتبط.

PlaceResult

تفاصيل عن نتيجة بحث مكان

الحقول
place

Place

تفاصيل عن مكان معيّن
distance_meters

float

المسافة المستقيمة من موقع البحث إلى شكل المكان أو مركزه

TrafficRestrictionEnums

أنواع القيود المفروضة على حركة المرور في موقع جغرافي معيّن

TrafficRestriction

قيمة قيود حركة المرور

عمليات التعداد
TRAFFIC_RESTRICTION_UNSPECIFIED لم يتم تحديد القيد.
NO_RESTRICTION ولا يتم فرض أي قيود على الزيارات.
OTHER_RESTRICTION قد تنطبق بعض القيود على حركة المرور، مثل أن تكون الطريق خاصة أو أن يتم تحصيل رسوم مقابل الوصول إلى الموقع الجغرافي المرتبط بها.

TravelDetail

التفاصيل المرتبطة بالسفر

الحقول
travel_mode

TravelMode

وضع السفر الذي يتم احتساب الوقت المقدر للوصول بموجبه.
estimated_arrival_time

Timestamp

الوقت المقدَّر للوصول يتم احتساب وقت الوصول بالمشي من الموقع الجغرافي للبحث إلى الموقع الجغرافي لنقطة الاستلام عند ضبط compute_walking_eta في الطلب. يتم احتساب الوقت المقدَّر للوصول بالسيارة من موقع نقطة الاستلام إلى الوجهة لكل طريقة سفر غير المشاة المطلوبة عند ضبط compute_driving_eta وdestination في الطلب. يتم احتساب وقت الوصول بالسيارة استنادًا إلى عدد المركبات، ولا يخضع لقيود الازدحام.
traffic_restriction

TrafficRestriction

القيود التي تنطبق على طريقة السفر

TravelModeEnums

قائمة أوضاع السفر المتاحة للتنقّل إلى موقع جغرافي

TravelMode

قيمة وضع السفر

عمليات التعداد
TRAVEL_MODE_UNSPECIFIED لم يتم تحديد وضع السفر.
WALKING المشي، يُستخدَم للمشاة.
DRIVING القيادة، المستخدَمة للسيارات التي تقلّ ركّابًا
TWO_WHEELER مركبة ذات عجلتين ومزوّدة بمحرّك (مثل دراجة نارية أو دراجة بخارية)

WiFiAccessPoint

معلومات نقطة وصول WiFi

الحقول
mac_address

int64

عنوان MAC لنقطة الوصول
strength_dbm

sint32

قوة إشارة نقطة الوصول بالديسيبل