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

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

string

الصيغة القصيرة لنص المكوِّن. تشمل الأمثلة كلاً من "CA" لـ "California" و "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

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

FindNearbyPlacesResponse

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

الحقول
place_results[]

PlaceResult

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

FindPickupPointsForLocationRequest

رسالة طلب Find PickupPointsForLocation

الحقول
localization_preferences

LocalizationPreferences

مطلوبة. التفضيلات المستخدمة لأقلمة النصوص في الرد، مثل الاسم والعنوان.
search_location

LatLng

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

PickupPointOrder

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

LatLng

موقع الوجهة المقصود للعميل. يتم ضبطها عند طلب نقاط الاستلام مرتّبة حسب الوقت المقدّر للوصول (ETA) للوجهة.
max_results

int32

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

TravelMode

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

bool

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

bool

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

WiFiAccessPoint

نقاط وصول WiFi حول موقع البحث يتم استخدامه لتقديم نتائج بحث ذات جودة أعلى.

FindPickupPointsForLocationResponse

العثور على نقاط الاستلام لرسالة الردّ على الموقع الجغرافي

الحقول
place_pickup_point_results[]

PlacePickupPointResult

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

PlaceResult

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

FindPickupPointsForPlaceRequest

رسالة طلب Find PickupPointsForPlace.

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

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

bool

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

FindPickupPointsForPlaceResponse

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

الحقول
pickup_point_results[]

PickupPointResult

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

PlaceResult

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

FormattedAddress

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

الحقول
lines[]

string

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

هندسة

هندسة المكان.

الحقول
location

LatLng

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

Viewport

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

Struct

تحديد مضلّع باستخدام تنسيق GeoJSON Polygon

LocalizationPreferences

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

الحقول
language_code

string

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

string

مطلوبة. رمز البلد/المنطقة يونيكود (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 صحيحًا. عندما يتم تقديم الطلب عدة أوضاع سفر، يستند الترتيب إلى أول وضع سفر في الطلب.

PickupPointResult

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

الحقول
pickup_point

PickupPoint

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

float

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

TrafficRestriction

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

TravelModeEnums

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

TravelMode

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

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

WiFiAccessPoint

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

الحقول
mac_address

int64

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

sint32

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