Package google.maps.geocode.v4alpha

الفهرس

DestinationService

خدمة لاسترداد الوجهات

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

SearchDestinations

rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse)

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

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

يجب توفير أحد نطاقات OAuth التالية:

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

الوجهة

وجهة ويشمل ذلك المكان الأساسي والأماكن ذات الصلة والمداخل ونقاط التنقّل.

الحقول
primary

PlaceView

المكان الأساسي الذي يحدّده primary_query في الطلب.
containing_places[]

PlaceView

الأماكن الأقل دقة التي يقع فيها المكان الأساسي على سبيل المثال، المجمّع السكني الذي يضمّ هذا المبنى
sub_destinations[]

PlaceView

أماكن فرعية أكثر دقة ضمن المكان الأساسي على سبيل المثال، الوحدات المتوفرة في مبنى

ملاحظة: بالمقارنة مع SubDestination التي تعرضها Places API، تكون قائمة الوجهات الفرعية هذه أكثر شمولاً، وتحتوي كل وجهة فرعية على المزيد من المعلومات.
landmarks[]

Landmark

المعالم التي يمكن استخدامها لتحديد مكان الوجهة أو المساعدة في الوصول إليها
entrances[]

Entrance

مداخل هذه الوجهة
navigation_points[]

NavigationPoint

نقاط التنقّل لهذه الوجهة

المدخل

المدخل هو زوج واحد من إحداثيات خطوط الطول والعرض يحدّد موقع نقطة الدخول والخروج من مكان معيّن.

الحقول
location

LatLng

تمثّل هذه السمة موقع المدخل.
tags[]

Entrance.Tag

قائمة بالعلامات التي تصف المدخل
place

string

تمثّل هذه السمة البنية التي يقع عليها المدخل فعليًا، وذلك بتنسيق places/{place_id}.

العلامة

الخصائص التي تصف مدخلاً

عمليات التعداد
TAG_UNSPECIFIED لم يتم استخدامه.
PREFERRED

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

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

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

ملاحظة: قد لا يتيح المدخل PREFERRED الوصول إلى المكان الأساسي، وقد يتيح المدخل غير PREFERRED الوصول إلى المكان الأساسي.

مَعلم

تُستخدَم المعالم لتحديد مكان الوجهة أو المساعدة في الوصول إليها.

الحقول
tags[]

Landmark.Tag

علامات تصف كيفية استخدام المعلم البارز في سياق الوجهة
حقل الدمج landmark المَعلم يمكن أن تكون landmark إحدى القيم التالية فقط:
place

PlaceView

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

العلامة

قائمة بجميع العلامات المحتملة التي تصف كيفية استخدام معلم بارز في سياق وجهة

إذا كان العنوان يتضمّن العلامتَين ADDRESS وARRIVAL، يعني ذلك أنّ المعلم بارز محليًا وقريب من الوجهة.

عمليات التعداد
TAG_UNSPECIFIED لم يتم استخدامه.
ADDRESS مكان بارز محليًا يمكن استخدامه لتحديد الموقع الجغرافي العام للوجهة عادةً ما تكون على بُعد بضع مئات من الأمتار من الوجهة. وهي تشبه المعالم التي تعرضها ميزة "أوصاف العناوين" في Geocoding API: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors.
ARRIVAL مكان يمكن استخدامه للمساعدة في الوصول إلى الوجهة تكون مفيدة للتنقّل عندما تكون بالقرب من الوجهة. على سبيل المثال، قد يكون هذا المعلم مكانًا يقع على الجانب الآخر من الشارع مقابل الوجهة. عادةً ما يكون المعلم الذي يحمل هذه العلامة أقرب إلى الوجهة من المعالم التي تحمل العلامة ADDRESS.

نقطة التنقّل هي موقع جغرافي بجانب طريق يمكن أن ينتهي التنقّل فيه.

الحقول
display_name

LocalizedText

الاسم المعروض لنقطة التنقّل هذه. على سبيل المثال، "شارع 5" أو "البوابة B".
location

LatLng

نقطة بجانب جزء الطريق الذي من المفترض أن ينتهي التنقّل فيه يتم إزاحة النقطة قليلاً عن خط المنتصف للطريق بشكل متعمّد لتحديد الجانب الذي يقع فيه المكان بوضوح.
travel_modes[]

NavigationPoint.TravelMode

وسائل النقل المناسبة لنقطة التنقّل هذه
usages[]

NavigationPoint.Usage

الاستخدامات التي تتيحها نقطة التنقّل هذه

TravelMode

وسائل النقل المناسبة لنقطة التنقّل هذه

عمليات التعداد
TRAVEL_MODE_UNSPECIFIED لم يتم استخدامه.
DRIVE مناسبة للقيادة
WALK مناسب للمشي

الاستخدام

الاستخدامات التي تتيحها نقطة التنقّل هذه

عمليات التعداد
USAGE_UNSPECIFIED لم يتم استخدامه.
UNKNOWN نوع الاستخدام غير معروف. ستكون معظم نقاط التنقّل UNKNOWN، ولا يعني ذلك بالضرورة أنّ استخدامها محظور بأي شكل من الأشكال. قد يكون هذا التنقّل مناسبًا للاستلام و/أو التسليم.
DROPOFF مناسبة لتوصيل راكب على سبيل المثال، موقع توصيل خدمة مشاركة الركوب
PICKUP مناسبة لإقلال راكب على سبيل المثال، موقع استلام رحلة مشاركة.

PlaceView

تمثّل هذه السمة طريقة عرض مكان في Places API. وتوفّر أيضًا معلومات إضافية خاصة بالمقاصد، مثل نوع البنية والمضلّع المعروض.

في بعض الحالات، قد يختلف PlaceView الذي يتضمّن رقم تعريف المكان نفسه عن البيانات التي تعرضها Places API للحقلَين types وdisplay_name.

الحقول
place

string

اسم المرجع الخاص بهذا المكان، بالتنسيق places/{placeId}
display_name

LocalizedText

وصف المكان يمكن لشخص عادي قراءته على سبيل المثال، "البوابة B" أو "ماكدونالدز"
primary_type

string

تمثّل هذه السمة نوع المكان الأساسي. يمكنك الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/place-types للحصول على قائمة بالقيم المحتملة.

ملاحظة: لا تتم تعبئة هذا الحقل دائمًا. يجب أن تكون مستعدًا لاستخدام الحقل types في مثل هذه الحالات.
types[]

string

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

string

عنوان من سطر واحد
postal_address

PostalAddress

عنوان منظَّم
structure_type

PlaceView.StructureType

تمثّل هذه السمة نوع البنية المتعلّقة بهذا المكان.
location

LatLng

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

Struct

تمثّل هذه السمة المخطط التفصيلي المضلّع للمكان بتنسيق GeoJSON، باستخدام تنسيق RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.

ملاحظة: يتيح تنسيق RFC 7946 استخدام MultiPolygons، لذا يمكن أن يمثّل عنصر display_polygon واحد مضلّعات متعددة.

StructureType

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

عمليات التعداد
STRUCTURE_TYPE_UNSPECIFIED لم يتم استخدامه.
POINT موقع جغرافي على شكل نقطة
SECTION قسم فرعي من مبنى
BUILDING مبنى
GROUNDS مساحة كبيرة تحتوي عادةً على مبانٍ متعددة، مثل حرم جامعي أو مجمّع سكني أو مركز تسوّق

SearchDestinationsRequest

طلب رسالة إلى DestinationService.SearchDestinations

الحقول
travel_modes[]

NavigationPoint.TravelMode

اختيارية: تمثّل هذه السمة وسائل النقل التي سيتم فلترة نقاط التنقّل وفقًا لها. يؤثّر ذلك في الحقل navigation_points الذي يتم عرضه في الردّ. إذا كان الحقل فارغًا، يمكن عرض نقاط التنقّل لجميع وسائل النقل.
language_code

string

اختيارية: اللغة التي يجب عرض النتائج بها
region_code

string

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

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

يتم إنشاء الوجهات استنادًا إلى طلب البحث الأساسي المحدّد.

ملاحظة: لا تتوفّر هذه الميزة إلا للأماكن والعناوين التي يمكن أن تكون وجهة للملاحة. على سبيل المثال، يمكن استخدام مكان يمثّل منزلاً أو مجمعًا سكنيًا كطلب البحث الأساسي، ولكن لا يمكن استخدام أماكن تمثّل منطقة أو منطقة إدارية كطلب البحث الأساسي. يمكن أن تكون primary_query إحدى القيم التالية فقط:
place

string

اسم المرجع الخاص بمكان، بتنسيق places/{place_id}
address_query

SearchDestinationsRequest.AddressQuery

تمثّل هذه السمة عنوان الشارع.
location_query

SearchDestinationsRequest.LocationQuery

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

AddressQuery

تمثّل هذه السمة عنوان الشارع الذي تريد البحث عنه. حدِّد العناوين وفقًا للتنسيق الذي تستخدمه خدمة البريد الوطنية في البلد المعنيّ.

الحقول
حقل الدمج kind طلب البحث عن العنوان يمكن أن تكون kind إحدى القيم التالية فقط:
address

PostalAddress

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

string

تمثّل هذه السمة عنوان الشارع المنسَّق كسطر واحد.

LocationQuery

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

ملاحظة: إذا كان طلب البحث عن الموقع الجغرافي ضمن مبنى يحتوي على أماكن فرعية، من المحتمل أن يكون المكان الأساسي الذي تم عرضه مكانًا فرعيًا. في هذه الحالات، سيتضمّن الحقل containing_places المبنى.

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

LatLng

موقع جغرافي دقيق بتنسيق LatLng

SearchDestinationsResponse

رسالة الردّ على DestinationService.SearchDestinations

الحقول
destinations[]

Destination

قائمة بالوجهات

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