Package google.maps.geocode.v4beta

الفهرس

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

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

تمثّل هذه السمة معرّف المكان المؤهَّل بالكامل لهذه النتيجة. بالتنسيق "//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 كل شيء آخر

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