Method: resolveNames

تحوّل هذه الخدمة قائمة بأسماء الأماكن (أو العناوين) إلى كيانات جغرافية مكانية محدّدة (مثل الأماكن) على "خرائط Google".

طلب HTTP

POST https://mapstools.googleapis.com/v1alpha:resolveNames

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

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "queries": [
    {
      object (LocationQuery)
    }
  ],
  "locationBias": {
    object (LocationBias)
  },
  "regionCode": string
}
الحقول
queries[]

object (LocationQuery)

الحقل مطلوب. قائمة بطلبات البحث عن المواقع الجغرافية التي يجب حلّها يمكنك تحديد ما يصل إلى 20 طلب بحث.
locationBias

object (LocationBias)

اختياريّ. منطقة اختيارية لتوجيه نتائج الحلّ في حال تحديد هذه المنطقة، ستكون نتائج الحلّ منحازة إلى الكيانات الأقرب إليها. يؤدي تضمين locationBias أو regionCode غالبًا إلى الحصول على نتائج أفضل من خلال تضييق نطاق البحث.

في حال تحديد كل من locationBias وregionCode، تكون الأولوية لـ locationBias على regionCode.
regionCode

string

اختياريّ. رمز منطقة اختياري لتوجيه نتائج الحلّ في حال تحديد هذه السمة، ستكون نتائج الحلّ منحازة إلى الكيانات الموجودة في المنطقة المحدّدة أو بالقرب منها. يجب أن يكون هذا رمز منطقة CLDR. على سبيل المثال، "US" أو "CA". يؤدي تضمين locationBias أو regionCode غالبًا إلى الحصول على نتائج أفضل من خلال تضييق نطاق البحث.

في حال تحديد كل من locationBias وregionCode، تكون الأولوية لـ locationBias على regionCode.

نص الاستجابة

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

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/maps-platform.mapstools