Package google.maps.geocode.v4beta

الفهرس

• GeocodeService (واجهة)
• GeocodeAddressRequest (رسالة)
• GeocodeAddressRequest.LocationBias (رسالة)
• GeocodeAddressResponse (رسالة)
• GeocodeLocationRequest (رسالة)
• GeocodeLocationResponse (رسالة)
• GeocodePlaceRequest (رسالة)
• GeocodeResult (رسالة)
• GeocodeResult.AddressComponent (رسالة)
• GeocodeResult.Granularity (تعداد)
• PlusCode (رسالة)

GeocodeService

خدمة لإجراء الترميز الجغرافي

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse) تُنفِّذ هذه الطريقة ترميزًا جغرافيًا للعنوان، ما يؤدي إلى ربط عنوان بزوج من القيم ("العرض الجغرافي" و"الطول الجغرافي"). وتوفّر أيضًا معلومات منظَّمة عن العنوان. نطاقات التفويض يتطلب أحد نطاقات 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) تُنفِّذ هذه الطريقة ترميزًا جغرافيًا للموقع الجغرافي، ما يؤدي إلى ربط خطوط الطول والعرض بعنوان. ويقدّم أيضًا معلومات منظَّمة عن العنوان. نطاقات التفويض يتطلب أحد نطاقات 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

GeocodeAddressRequest

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

الحقول
location_bias	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[]	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 معرّف المكان المؤهَّل بالكامل لهذه النتيجة. بتنسيق "//places.googleapis.com/places/{placeID}". اطّلِع على https://developers.google.com/maps/documentation/places/web-service/place-id لمزيد من التفاصيل.
place_id	string رقم تعريف المكان لهذه النتيجة.
location	LatLng خطوط الطول والعرض لهذا العنوان
granularity	Granularity دقة الموقع الجغرافي
viewport	Viewport إطار عرض مناسب لعرض نتيجة الرمز الجغرافي
bounds	Viewport مربّع محيط للعنوان
formatted_address	string العنوان المنسَّق في سطر واحد
postal_address	PostalAddress العنوان بتنسيق العنوان البريدي
address_components[]	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 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	كل شيء آخر

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