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