Method: resolveNames

แปลงรายการชื่อสถานที่ (หรือที่อยู่) เป็นเอนทิตีเชิงพื้นที่ที่เฉพาะเจาะจง (เช่น สถานที่) ใน Google Maps

คำขอ HTTP

POST https://mapstools.googleapis.com/v1: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

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ v1.resolveNames

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "results": [
    {
      object (Result)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  },
  "saveToMapsUrl": string
}
ช่อง
results[]

object (Result)

เอาต์พุตเท่านั้น รายการเอนทิตีที่ได้รับการแก้ไขจากการค้นหาสถานที่ตั้ง รับประกันว่าจะแมปแบบ 1:1 กับดัชนี queries ของคำขอ สตริงที่ว่างเปล่าที่ดัชนี i บ่งชี้ว่าการแปลงไม่สำเร็จสำหรับการค้นหานั้น หากการแก้ปัญหาล้มเหลว โปรดตรวจสอบช่อง failedRequests เพื่อดูสถานะข้อผิดพลาด
failedRequests

map (key: integer, value: object (Status))

เอาต์พุตเท่านั้น แผนที่ที่สื่อสารความล้มเหลวบางส่วน คีย์คือดัชนีของคำขอที่ดำเนินการไม่สำเร็จในช่อง queries ค่านี้คือสถานะข้อผิดพลาดที่ให้รายละเอียดสาเหตุที่การแก้ปัญหาล้มเหลว

ออบเจ็กต์ที่มีรายการคู่ "key": value เช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
saveToMapsUrl

string

เอาต์พุตเท่านั้น ลิงก์สำหรับบันทึกเอนทิตีที่แก้ไขสำเร็จทั้งหมดใน Google Maps

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

LocationQuery

คำค้นหาสถานที่แสดงถึงเอนทิตีสถานที่ที่เฉพาะเจาะจงซึ่งสามารถแก้ไขได้ด้วย Google Maps ปัจจุบันระบบรองรับเฉพาะชื่อสถานที่และที่อยู่เป็นคำค้นหาสถานที่เท่านั้น

การแสดง JSON 
{
  "text": string
}
ช่อง
text

string

ต้องระบุ คำค้นหาข้อความเพื่อแก้ไขเอนทิตีเชิงพื้นที่ทางภูมิศาสตร์ที่เฉพาะเจาะจงใน Google Maps เช่น สถานที่หรือที่อยู่ ยิ่งคำค้นหาเจาะจงมากเท่าใด การแก้ไขก็จะยิ่งแม่นยำมากขึ้นเท่านั้น เช่น "San Francisco", "Googleplex, Mountain View, CA", "1600 Amphitheatre Parkway, Mountain View, CA" หรือ "Eiffel Tower, Paris" คำค้นหาต้องเป็นที่อยู่หรือชื่อสถานที่ที่เจาะจง ระบบไม่รองรับสถานที่ตั้งทั่วไป เช่น ชื่อเครือร้าน (เช่น Starbucks) หรือคำค้นหา เช่น "ร้านอาหาร"

LocationBias

ภูมิภาคที่จะให้น้ำหนักกับผลการแปลงที่อยู่

การแสดง JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "viewport": {
    object (Viewport)
  }
  // End of mutually exclusive fields.
}
ช่อง
ประเภทของการให้น้ำหนักพิเศษตามสถานที่ตั้ง ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
viewport

object (Viewport)

วิวพอร์ตที่กำหนดโดยกรอบล้อมรอบ
สิ้นสุดฟิลด์ที่แยกกัน

ผลลัพธ์

เอนทิตีที่ได้รับการแก้ไขรายการเดียวจากคำค้นหาสถานที่ที่ระบุ พร้อมด้วยระดับความเชื่อมั่นของการแก้ไข

การแสดง JSON 
{
  "entity": {
    object (Entity)
  },
  "confidence": enum (Confidence)
}
ช่อง
entity

object (Entity)

เอาต์พุตเท่านั้น เอนทิตีที่ได้รับการแก้ไขจากคำค้นหาสถานที่
confidence

enum (Confidence)

เอาต์พุตเท่านั้น ระดับความเชื่อมั่นในการแก้ปัญหา

ความเชื่อมั่น

ระดับความเชื่อมั่นในการแก้ปัญหา

Enum
CONFIDENCE_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้
MEDIUM ความมั่นใจปานกลางบ่งชี้ว่าการแก้ไขน่าจะถูกต้อง แต่อาจมีตัวเลือกอื่นๆ
HIGH ความเชื่อมั่นสูงบ่งชี้ว่าการแปลงข้อมูลถูกต้องและแสดงถึงเอนทิตีเชิงพื้นที่ที่เฉพาะเจาะจง (เช่น สถานที่ที่เฉพาะเจาะจง)