Method: geocode.address.geocodeAddress

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

طلب HTTP

GET https://geocode.googleapis.com/v4alpha/geocode/address

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات طلب البحث

المعلمات
locationBias

object (GeocodeAddressRequest.LocationBias)

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

string

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

string

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

enum (GeocodeAddressRequest.Effort)

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

string

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

object (PostalAddress)

العنوان المنظَّم المطلوب ترميزه جغرافيًا بتنسيق العنوان البريدي
نهاية الحقول التي يستبعد كلّ منها الآخر

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال 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