Method: geocode.address.geocodeAddress

• طلب HTTP
• معامِلات طلب البحث
• نص الطلب
• نص الاستجابة
• نطاقات التفويض

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

طلب HTTP

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

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

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

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