Method: resolveNames

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

คำขอ 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

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

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

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

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

object (Result)

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

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

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

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

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

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

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

LocationQuery

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

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

string

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

LocationBias

ภูมิภาคที่จะใช้เพื่อเอนเอียงผลลัพธ์ความละเอียด

การแสดง JSON 
{

  // Union field type can be only one of the following:
  "viewport": {
    object (Viewport)
  }
  // End of list of possible types for union field type.
}
ช่อง
ฟิลด์ Union type ประเภทของการเอนเอียงตามสถานที่ type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
viewport

object (Viewport)

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

วิวพอร์ต

วิวพอร์ตในรูปแบบละติจูด-ลองจิจูด ซึ่งกำหนดด้วยจุด low และ high สองจุดที่อยู่มุมตรงข้ามกัน วิวพอร์ตถือเป็นพื้นที่ปิด ซึ่งหมายรวมถึงขอบเขตของตัววิวพอร์ตเองด้วย ขอบเขตละติจูดต้องอยู่ระหว่าง -90 ถึง 90 องศา และขอบเขตลองจิจูดต้องอยู่ระหว่าง -180 ถึง 180 องศา ตัวอย่างกรณีต่างๆ ได้แก่

  • หาก low = high วิวพอร์ตจะประกอบด้วยจุดเดียว

  • หาก low.longitude > high.longitude ช่วงลองจิจูดจะกลับด้าน (วิวพอร์ตข้ามเส้นลองจิจูด 180 องศา)

  • หาก low.longitude = -180 องศา และ high.longitude = 180 องศา วิวพอร์ตจะครอบคลุมลองจิจูดทั้งหมด

  • หาก low.longitude = 180 องศา และ high.longitude = -180 องศา ช่วงลองจิจูดจะว่างเปล่า

  • หาก low.latitude > high.latitude ช่วงละติจูดจะว่างเปล่า

คุณต้องระบุทั้ง low และ high และช่องที่แสดงต้องไม่ว่าง (ตามที่ระบุไว้ในคำจำกัดความข้างต้น) โดยวิวพอร์ตที่ว่างเปล่าจะทำให้เกิดข้อผิดพลาด

ตัวอย่างเช่น วิวพอร์ตนี้ครอบคลุมนิวยอร์กซิตี้ทั้งหมด

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

การแสดง JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
ช่อง
low

object (LatLng)

ต้องระบุ จุดต่ำสุดของวิวพอร์ต
high

object (LatLng)

ต้องระบุ จุดสูงสุดของวิวพอร์ต

LatLng

ออบเจ็กต์ที่แสดงคู่ละติจูด/ลองจิจูด โดยจะแสดงเป็นคู่ของจำนวนทศนิยมเพื่อแสดงองศาของละติจูดและองศาของลองจิจูด ออบเจ็กต์นี้ต้องเป็นไปตาม มาตรฐาน WGS84 เว้นแต่จะระบุไว้เป็นอย่างอื่น ค่าต้องอยู่ในช่วงที่ทำให้เป็นปกติ

การแสดง JSON 
{
  "latitude": number,
  "longitude": number
}
ช่อง
latitude

number

ละติจูดเป็นองศา ต้องอยู่ในช่วง [-90.0, +90.0]
longitude

number

ลองจิจูดเป็นองศา โดยต้องอยู่ในช่วง [-180.0, +180.0]

ผลลัพธ์

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

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

object (Entity)

เอาต์พุตเท่านั้น เอนทิตีที่แก้ไขแล้วจากคำค้นหาตำแหน่ง
confidence

enum (Confidence)

เอาต์พุตเท่านั้น ระดับความเชื่อมั่นสำหรับความละเอียด

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

ระดับความเชื่อมั่นสำหรับความละเอียด

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