Method: geocode.address.geocodeAddressQuery

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

طلب HTTP

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

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

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

المعلمات
مَعلمة الاتحاد address_input تمثّل هذه السمة العنوان المطلوب ترميز موقعه الجغرافي. يمكن أن تكون address_input إحدى القيم التالية فقط:
addressQuery

string

العنوان غير المنظَّم الذي سيتم ترميزه جغرافيًا.

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

المعلمات
locationBias

object (GeocodeAddressRequest.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