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
  • https://www.googleapis.com/auth/maps-platform.destinations

GeocodeService

خدمة لتنفيذ الترميز الجغرافي

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

تنفّذ هذه الطريقة الترميز الجغرافي للعنوان، ما يؤدي إلى ربط العنوان بـ LatLng. وتوفّر أيضًا معلومات منظَّمة حول العنوان.

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

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

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

rpc GeocodeLocation(GeocodeLocationRequest) returns (GeocodeLocationResponse)

تنفّذ هذه الطريقة الترميز الجغرافي للموقع الجغرافي، ما يؤدي إلى ربط LatLng بعنوان. وتوفّر أيضًا معلومات منظَّمة حول العنوان.

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

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

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

rpc GeocodePlace(GeocodePlaceRequest) returns (GeocodeResult)

تُجري هذه الطريقة عملية بحث عن الرمز الجغرافي باستخدام رقم تعريف المكان.

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

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

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

الوجهة

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

الحقول
primary

PlaceView

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

PlaceView

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

PlaceView

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

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

Landmark

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

Entrance

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

NavigationPoint

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

Destination.ParkingOptions

خيارات مواقف السيارات في هذه الوجهة
arrival_summary

Destination.ArrivalSummary

ملخّص من إنشاء الذكاء الاصطناعي حول تجربة الوصول إلى الوجهة

ArrivalSummary

ملخّص من إنشاء الذكاء الاصطناعي حول تجربة الوصول إلى الوجهة

الحقول
text

LocalizedText

ملخّص لتجربة الوصول إلى الوجهة
flag_content_url

string

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

LocalizedText

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

ParkingOptions

معلومات عن خيارات ركن السيارة في الوجهة

الحقول
availability

Destination.ParkingOptions.Availability

تعرض هذه السمة معلومات توفّر مواقف السيارات في هذه الوجهة.
onsite_parking

bool

تتوفر مواقف للسيارات في موقع الوجهة.
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

يوفّر موقف سيارات مدفوع في مرآب

مدى التوفّر

مقياس مجمّع لمدى صعوبة العثور على موقف سيارات عند زيارة هذا المكان

قد تتم إضافة قيم جديدة في المستقبل.

عمليات التعداد
AVAILABILITY_UNSPECIFIED لا تتوفّر معلومات حول إمكانية توفّر مواقف للسيارات.
PLENTY تتوفّر مواقف سيارات كافية.
SOMEWHAT_DIFFICULT من الصعب نوعًا ما العثور على موقف سيارات.
DIFFICULT من الصعب جدًا العثور على موقف سيارات.

المدخل

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

الحقول
location

LatLng

تمثّل هذه السمة الموقع الجغرافي للمدخل.
tags[]

Entrance.Tag

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

string

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

StreetViewThumbnail

صورة مصغّرة لـ "التجوّل الافتراضي" تعرض المدخل يمكن طلب الصورة من Street View Static API. يُرجى الاطّلاع على https://developers.google.com/maps/documentation/streetview/request-streetview.
street_view_annotation

ImageAnnotation

تعليق توضيحي حول المدخل الذي تم عرضه في street_view_thumbnail أعلاه

العلامة

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

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

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

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

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

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

GeocodeAddressRequest

رسالة الطلب الخاصة بـ GeocodeService.GeocodeAddress

الحقول
location_bias

GeocodeAddressRequest.LocationBias

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

string

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

string

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

string

العنوان غير المنظَّم المطلوب ترميزه جغرافيًا
address

PostalAddress

العنوان المنظَّم الذي سيتم ترميزه جغرافيًا بتنسيق العنوان البريدي

LocationBias

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

الحقول
حقل الربط type أنواع التحيز المرتبط بالموقع الجغرافي يمكن أن يكون التعليق type إحدى القيم التالية فقط:
rectangle

Viewport

مربّع مستطيل الشكل محدّد بالزاوية الشمالية الشرقية والزاوية الجنوبية الغربية يجب أن تكون rectangle.high() هي النقطة الشمالية الشرقية لمنطقة العرض المستطيلة. يجب أن تكون rectangle.low() هي النقطة الجنوبية الغربية لمنطقة عرض المستطيل. لا يمكن أن تكون قيمة rectangle.low().latitude() أكبر من rectangle.high().latitude(). سيؤدي ذلك إلى نطاق خطوط عرض فارغ. لا يمكن أن يزيد عرض إطار العرض المستطيل عن 180 درجة.

GeocodeAddressResponse

رسالة الردّ على GeocodeService.GeocodeAddress

الحقول
results[]

GeocodeResult

نتيجة الترميز الجغرافي

GeocodeLocationRequest

طلب رسالة GeocodeService.GeocodeLocation

الحقول
language_code

string

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

string

اختياريّ. رمز المنطقة رمز المنطقة، ويتم تحديده كقيمة من حرفين ccTLD ("نطاق المستوى الأعلى"). تؤثّر المَعلمة في النتائج استنادًا إلى القانون الساري.
types[]

string

اختياريّ. مجموعة من علامات النوع لحصر النتائج تتم إزالة النتائج التي لا تتضمّن أيًا من الأنواع المحدّدة.

للاطّلاع على القائمة الكاملة بالقيم المحتملة، يُرجى الرجوع إلى الجدول "أ" والجدول "ب" على الرابط https://developers.google.com/maps/documentation/places/web-service/place-types.
granularity[]

GeocodeResult.Granularity

اختياريّ. فلتر يتضمّن قيمة تعدادية واحدة أو أكثر لمستوى تفاصيل الموقع الجغرافي.
حقل الربط location_input الموقع الجغرافي المطلوب ترميزه يمكن أن يكون التعليق location_input إحدى القيم التالية فقط:
location_query

string

الموقع الجغرافي بالتنسيق "lat,lng" (خط العرض، خط الطول). على سبيل المثال، "64.7611872,-18.4705364".
location

LatLng

الموقع الجغرافي بالتنسيق المنظَّم

GeocodeLocationResponse

رسالة الردّ على GeocodeService.GeocodeLocation

الحقول
results[]

GeocodeResult

نتيجة الترميز الجغرافي
plus_code

PlusCode

رمز Plus Codes للموقع الجغرافي في الطلب

GeocodePlaceRequest

رسالة الطلب الخاصة بـ GeocodeService.GeocodePlace

الحقول
place

string

الحقل مطلوب. معرّف المكان المطلوب ترميزه جغرافيًا بالتنسيق places/{place}.
language_code

string

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

string

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

GeocodeResult

تحتوي نتيجة الرمز الجغرافي على معلومات جغرافية حول مكان معيّن.

الحقول
place

string

إجراء مطلوب لمستخدمي الإصدار v4alpha/v4beta: سيتم قريبًا تعديل هذا الحقل من التنسيق القديم "//places.googleapis.com/places/{placeID}" إلى التنسيق الجديد "places/{placeId}". تأكَّد من أنّ تطبيقك يمكنه التعامل مع كلا التنسيقَين خلال الفترة الانتقالية. من المتوقّع أن يتم إيقاف التنسيق القديم نهائيًا بحلول أواخر مايو 2026.

تمثّل هذه السمة معرّف المكان المؤهَّل بالكامل لهذه النتيجة. بالتنسيق "//places.googleapis.com/places/{placeID}". لمزيد من التفاصيل، يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/place-id.
place_id

string

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

LatLng

تمثّل هذه السمة خطوط الطول والعرض لهذا العنوان.
granularity

GeocodeResult.Granularity

تمثّل هذه السمة دقة الموقع الجغرافي.
viewport

Viewport

نافذة عرض مناسبة لعرض نتيجة الترميز الجغرافي
bounds

Viewport

مربع إحاطة للعنوان
formatted_address

string

العنوان المنسَّق في سطر واحد
postal_address

PostalAddress

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

GeocodeResult.AddressComponent

عناصر متكرّرة لكل مستوى من مستويات الموقع الجغرافي
postal_code_localities[]

LocalizedText

قائمة كاملة بالمناطق المحلية المتضمّنة في الرمز البريدي

لا تتم تعبئة هذا الحقل إلا عندما تكون النتيجة من النوع "postal_code".
types[]

string

مجموعة من علامات النوع لهذه النتيجة على سبيل المثال، "سياسي" و "منطقة إدارية".

للاطّلاع على القائمة الكاملة بالقيم المحتملة، يُرجى الرجوع إلى الجدول "أ" والجدول "ب" على الرابط https://developers.google.com/maps/documentation/places/web-service/place-types.
plus_code

PlusCode

رمز Plus Codes للموقع الجغرافي في هذا الرمز الجغرافي

AddressComponent

المكوّنات المنظَّمة التي تشكّل العنوان المنسَّق، إذا كانت هذه المعلومات متاحة

الحقول
long_text

string

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

string

اسم نصي مختصر لمكوّن العنوان، إذا كان متاحًا على سبيل المثال، قد يتضمّن أحد عناصر العنوان الخاص ببلد أستراليا اسمًا مختصرًا هو "AU".
types[]

string

مصفوفة تشير إلى أنواع مكوّنات العنوان.

يمكنك الاطّلاع على https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types لمزيد من التفاصيل.
language_code

string

تمثّل هذه السمة اللغة المستخدَمة لتنسيق هذا المكوّن، وذلك بتنسيق CLDR.

الدقة

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

عمليات التعداد
GRANULARITY_UNSPECIFIED لا تستخدم هذه السمة.
ROOFTOP الموقع الجغرافي غير المستند إلى الاستيفاء لقطعة أرض فعلية تتطابق مع العنوان الذي تمّت مطابقته
RANGE_INTERPOLATED تم استيفاؤها من نطاق أرقام الشوارع. على سبيل المثال، إذا علمنا أنّ جزءًا من شارع Amphitheatre Pkwy يتضمّن الأرقام 1600 إلى 1699، يمكن وضع الرقم 1650 في منتصف المسافة بين نقطتَي النهاية.
GEOMETRIC_CENTER المركز الهندسي لعنصر يتضمّن بيانات مضلّعية
APPROXIMATE كل شيء آخر

ImageAnnotation

تعليق توضيحي على صورة مصغّرة، مثل مضلّع يحدّد مدخلاً

الحقول
coordinates[]

ImageAnnotation.Coordinate

قائمة بالإحداثيات التي تشكّل مضلّعًا في الصورة يتم ترتيب الإحداثيات عكس اتجاه عقارب الساعة.

الإحداثيات

إحداثي البكسل لنقطة في الصورة نقطة الأصل (0,0) هي الزاوية العلوية اليمنى من البكسل العلوي الأيسر للصورة، مع توجيه المحور x إلى اليمين والمحور y إلى الأسفل.

الحقول
x_px

float

الإحداثي X
y_px

float

الإحداثي Y

مَعلم

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

الحقول
relational_description

LocalizedText

وصف يمكن لشخص عادي قراءته يوضح مدى صلة الوجهة بالمعلم على سبيل المثال: "بالقرب من مبنى Empire State" أو "مقابل البيت الأبيض".
tags[]

Landmark.Tag

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

double

النتائج فقط. المسافة في خط مستقيم من هذا المعلم إلى الوجهة بالمتر
travel_distance_meters

double

النتائج فقط. المسافة بين هذا المَعلم والوجهة على شبكة الطرق بالمتر
حقل الربط 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.

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

الحقول
navigation_point_token

string

النتائج فقط. رمز مميّز يمكن استخدامه لتحديد نقطة التنقّل هذه.
display_name

LocalizedText

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

LatLng

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

NavigationPoint.TravelMode

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

NavigationPoint.Usage

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

StreetViewThumbnail

صورة مصغّرة لميزة "التجوّل الافتراضي" تعرض نقطة التنقّل، إذا كانت متاحة يمكن طلب الصورة من Street View Static API. يُرجى الاطّلاع على https://developers.google.com/maps/documentation/streetview/request-streetview.
entrance_annotation

ImageAnnotation

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

float

تمثّل هذه السمة ارتفاع نقطة التنقّل بالأمتار بالنسبة إلى المجسم الإهليلجي WGS-84.

TravelMode

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

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

الاستخدام

الاستخدامات التي تتيحها نقطة التنقّل هذه قد تتم إضافة قيم جديدة في المستقبل.

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

PlaceView

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

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

الحقول
place

string

إجراء مطلوب لمستخدمي الإصدار v4alpha/v4beta: سيتم قريبًا تعديل هذا الحقل من التنسيق القديم "//places.googleapis.com/places/{placeID}" إلى التنسيق الجديد "places/{placeId}". تأكَّد من أنّ تطبيقك يمكنه التعامل مع كلا التنسيقَين خلال الفترة الانتقالية. من المتوقّع أن يتم إيقاف التنسيق القديم نهائيًا بحلول أواخر مايو 2026.

تمثّل هذه السمة معرّف المكان المؤهَّل بالكامل لهذه النتيجة. بالتنسيق "//places.googleapis.com/places/{placeID}". لمزيد من التفاصيل، يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/place-id.
place_id

string

المعرّف الفريد للمكان
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 مساحة كبيرة تحتوي عادةً على مبانٍ متعددة، مثل مجمّع جامعي أو مجمّع سكني أو مركز تسوّق

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، رامبرغ، النرويج"، الذي يحتوي على لاحقة الرمز العالمي ويستبدل البادئة باسم منسَّق لكيان مرجعي

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 المبنى.

الحقول
place_filter

SearchDestinationsRequest.LocationQuery.PlaceFilter

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

LatLng

موقع جغرافي دقيق بنظام الإحداثيات LatLng

PlaceFilter

الفلاتر التي سيتم تطبيقها على المرشّحين للوجهة

الحقول
structure_type

PlaceView.StructureType

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

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

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

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

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

إمكانية الاستهداف

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

عمليات التعداد
ADDRESSABILITY_UNSPECIFIED في حال عدم تحديد ذلك، ستختار الخدمة قيمة تلقائية مناسبة.
ANY لا تشكّل إمكانية الاستهداف معيارًا للفلترة. يتم عرض الوجهات بغض النظر عن إمكانية استهدافها.
PRIMARY ستتضمّن جميع الوجهات التي يتم عرضها مكانًا أساسيًا يتضمّن عنوانًا أو اسمًا على مستوى الشارع.
WEAK ستتضمّن جميع الوجهات التي يتم عرضها إما مكانًا أساسيًا أو وجهة فرعية مع عنوان أو اسم على مستوى الشارع.

SearchDestinationsResponse

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

الحقول
destinations[]

Destination

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

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

StreetViewThumbnail

مَعلمات لتمثيل صورة مصغّرة في "التجوّل الافتراضي من Google". يمكن استخدام هذه المَعلمات لطلب صورة "التجوّل الافتراضي" من Street View Static API. يُرجى الاطّلاع على https://developers.google.com/maps/documentation/streetview/request-streetview.

الحقول
pano

string

معرّف بانوراما محدّد
width_px

int32

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

int32

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

float

الاتجاه الأفقي للكاميرا بالدرجات النطاق [0, 360). يشير الرقم 0 إلى الشمال والرقم 90 إلى الشرق.
pitch_degree

float

تمثّل هذه السمة اتجاه الكاميرا العمودي بالدرجات. النطاق [-90, 90]. 0 هو الأفق، و+90 هو للأعلى مباشرةً، و-90 هو للأسفل مباشرةً.
fov_degree

float

مجال الرؤية الأفقي بالدرجات النطاق (0, 180]. يتحكّم في مستوى التكبير أو التصغير. كلما كان مجال الرؤية أصغر، زاد التكبير.