Method: geocode.address.geocodeAddressQuery

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

طلب HTTP

GET https://geocode.googleapis.com/v4beta/geocode/address/{addressQuery}

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

مَعلمات المسار

المعلمات
مَعلمة الائتلاف address_input. العنوان المطلوب ترميزه جغرافيًا يمكن أن يكون address_input واحدًا فقط مما يلي:
addressQuery

string

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

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

المعلمات
locationBias

object (LocationBias)

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

string

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

string

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