Method: geocode.address.geocodeAddressQuery

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

طلب HTTP

GET https://geocode.googleapis.com/v4beta/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