Method: geocode.places.geocodePlace

تُجري هذه الطريقة عملية بحث عن رمز جغرافي باستخدام رقم تعريف مكان.

طلب HTTP

GET https://geocode.googleapis.com/v4beta/geocode/{place=places/*}

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

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

المعلمات
place

string

مطلوب. معرّف المكان لرمز جغرافي بتنسيق places/{place}

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

المعلمات
languageCode

string

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

regionCode

string

اختياريّ. رمز المنطقة رمز المنطقة، المحدّد كقيمة مكوّنة من حرفَين لنطاق المستوى الأعلى لرموز البلدان (ccTLD) تؤثر المَعلمة في النتائج استنادًا إلى القانون الساري.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال GeocodeResult.

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.place