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

توضّح هذه السمة مدى توفّر مواقف للسيارات في هذه الوجهة.
parking_facilities[]

Destination.ParkingOptions.ParkingFacility

مرافق مواقف السيارات في هذه الوجهة
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 من الصعب جدًا العثور على موقف سيارات.

ParkingFacility

خيار فردي ومنفصل لركن السيارات (مثل مرآب سيارات أو موقف سيارات معيّن) مرتبط بالوجهة يوفّر ذلك معلومات تفصيلية عن موقف سيارات معيّن، في حين تقدّم رسالة ParkingOptions الرئيسية ملخّصًا مجمّعًا لجميع مواقف السيارات المتاحة.

الحقول
place

PlaceView

تمثيل المكان لموقف السيارات المحدّد هذا
onsite

bool

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

bool

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

double

المسافة المستقيمة بالمتر من الوجهة الأساسية إلى موقف السيارات هذا

المدخل

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

الحقول
display_name

LocalizedText

اسم يمكن لشخص عادي قراءته، مثل "البوابة ب" أو "المدخل الجنوبي" أو "مدخل الجادة الخامسة".
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 Code للموقع الجغرافي في الطلب

GeocodePlaceRequest

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

الحقول
place

string

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

string

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

string

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

GeocodeResult

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

الحقول
place

string

اسم مورد هذا المكان، بتنسيق places/{placeId}. يمكن استخدامها للبحث عن المكان.
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

مجموعة من علامات الأنواع لهذه النتيجة على سبيل المثال، "political" و "administrative_area".

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

PlusCode

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

AddressComponent

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

الحقول
long_text

string

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

string

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

string

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

يتم استخلاص هذه القيم من جدول أنواع العناوين وأنواع مكوّنات العناوين الذي تستخدمه Places API: https://developers.google.com/maps/documentation/places/web-service/place-types#address-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_px

float

الإحداثي X
y_px

float

الإحداثي Y

مَعلم

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

الحقول
relational_description

LocalizedText

وصف يمكن لشخص عادي قراءته لكيفية ارتباط الوجهة بالمعلم على سبيل المثال: "بالقرب من مبنى إمباير ستيت" أو "مقابل البيت الأبيض".
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

الاسم المعروض لنقطة التنقّل هذه على سبيل المثال، "الشارع الخامس" أو "البوابة ب".
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

اسم مورد هذا المكان، بتنسيق places/{placeId}. يمكن استخدامها للبحث عن المكان.
place_id

string

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

LocalizedText

وصف للمكان يمكن لشخص عادي قراءته على سبيل المثال، "البوابة ب" أو "ماكدونالدز"
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 واحد مضلّعات متعدّدة.
address_components[]

PlaceView.AddressComponent

مكوّنات متكرّرة لكل مستوى منطقة

AddressComponent

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

الحقول
long_text

string

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

string

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

string

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

يتم استخلاص هذه القيم من جدول أنواع العناوين وأنواع مكوّنات العناوين الذي تستخدمه Places API: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types
language_code

string

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

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

SearchDestinationsRequest

رسالة طلب لـ DestinationService.SearchDestinations.

الحقول
travel_modes[]

NavigationPoint.TravelMode

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

string

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

string

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

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

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

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

موقع جغرافي دقيق يمثّل خطوط الطول والعرض

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

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

int32

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

float

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

float

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

float

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