รายละเอียดสถานที่ (ใหม่)

เลือกแพลตฟอร์ม Android iOS JavaScript บริการผ่านเว็บ

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

การรับรหัสสถานที่ทำได้หลายวิธี คุณสามารถใช้

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

ลองใช้งาน

คำขอรายละเอียดสถานที่ (ใหม่)

คำขอรายละเอียดสถานที่เป็นคำขอ HTTP GET ในรูปแบบ

https://places.googleapis.com/v1/places/PLACE_ID

ส่งพารามิเตอร์ทั้งหมดเป็นพารามิเตอร์ของ URL หรือในส่วนหัวเป็นส่วนหนึ่งของ คำขอ GET เช่น

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

หรือในคำสั่ง cURL:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

การตอบกลับรายละเอียดสถานที่ (ใหม่)

รายละเอียดสถานที่ (ใหม่) แสดง ออบเจ็กต์ JSON เป็นการตอบกลับ ในการตอบกลับ:

  • คำตอบจะแสดงด้วย Place ออบเจ็กต์ ออบเจ็กต์ Place มีข้อมูลโดยละเอียดเกี่ยวกับ
  • FieldMask ที่ส่งผ่านในคำขอระบุรายการช่อง แสดงในออบเจ็กต์ Place

ออบเจ็กต์ JSON ที่สมบูรณ์อยู่ในรูปแบบดังนี้

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

พารามิเตอร์ที่จำเป็น

  • FieldMask

    ระบุรายการช่องที่จะส่งกลับมาในคำตอบโดยสร้าง มาสก์ของช่องตอบกลับ ส่งมาสก์ฟิลด์ตอบกลับไปยังเมธอดโดยใช้พารามิเตอร์ของ URL $fields หรือ fields หรือใช้ส่วนหัว HTTP X-Goog-FieldMask คำตอบไม่มีรายการเริ่มต้นของช่องที่ส่งคืน หากคุณไม่มาสก์ช่อง เมธอดจะแสดงข้อผิดพลาด

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

    ระบุรายการประเภทข้อมูลสถานที่ซึ่งคั่นด้วยคอมมาที่จะแสดงผล ตัวอย่างเช่น เพื่อดึงข้อมูลชื่อที่แสดงและที่อยู่ของสถานที่

    X-Goog-FieldMask: displayName,formattedAddress

    ใช้ * เพื่อเรียกข้อมูลช่องทั้งหมด

    X-Goog-FieldMask: *

    ระบุช่องต่อไปนี้อย่างน้อย 1 ช่อง

  • placeId

    ตัวระบุแบบข้อความที่ระบุสถานที่โดยไม่ซ้ำกัน แสดงผลจาก การค้นหาข้อความ (ใหม่) หรือ การค้นหาใกล้เคียง (ใหม่) สำหรับข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ โปรดดูที่ ภาพรวมรหัสสถานที่

    มีอีกชื่อหนึ่งว่าสตริง places/PLACE_ID คือ ชื่อทรัพยากร ในการตอบกลับจากรายละเอียดสถานที่ (ใหม่) การค้นหาใกล้เคียง (ใหม่) และการค้นหาข้อความ (ใหม่) สตริงนี้จะอยู่ในช่อง name ของการตอบกลับ แบบสแตนด์อโลน รหัสสถานที่จะอยู่ในช่อง id ของคำตอบ

พารามิเตอร์ที่ไม่บังคับ

  • languageCode

    ภาษาที่จะแสดงผลการค้นหา

    • โปรดดู รายชื่อภาษาที่รองรับ Google มีการอัปเดตบ่อยครั้ง ภาษาที่รองรับ รายการนี้จึงอาจเป็นเพียงตัวอย่างบางส่วนเท่านั้น
    • หากไม่ได้ระบุ languageCode ค่าเริ่มต้นของ API จะเป็น en ถ้า คุณระบุรหัสภาษาไม่ถูกต้อง API จะแสดงข้อผิดพลาด INVALID_ARGUMENT
    • API พยายามอย่างสุดความสามารถเพื่อให้ที่อยู่ที่อ่านได้ง่ายสำหรับ ทั้งผู้ใช้และคนในพื้นที่ เพื่อให้บรรลุเป้าหมายนี้ โมเดลจึงส่งคืนที่ถนน ที่อยู่ในภาษาท้องถิ่น ถอดเสียงเป็นสคริปต์ที่อ่านได้ ถ้าจำเป็น โดยสังเกตภาษาที่ต้องการ อื่นๆ ทั้งหมด ที่อยู่จะแสดงเป็นภาษาที่ต้องการ องค์ประกอบที่อยู่คือ ทั้งหมดจะแสดงผลในภาษาเดียวกัน โดยเลือกจาก คอมโพเนนต์
    • หากไม่มีชื่อในภาษาที่ต้องการ API จะใช้ ที่ใกล้เคียงที่สุด
    • ภาษาที่ต้องการจะมีอิทธิพลเล็กน้อยต่อชุดผลลัพธ์ที่ API เลือกจะแสดงผล และลำดับการส่งกลับ โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์จะแปลตัวย่อแตกต่างกันไปตามภาษา เช่น ตัวย่อของประเภทถนน หรือคำพ้องความหมาย ใช้ได้ในภาษาหนึ่ง แต่ไม่ใช่อีกภาษาหนึ่ง
  • regionCode

    รหัสภูมิภาคที่ใช้ในการจัดรูปแบบการตอบกลับ ระบุเป็น ค่ารหัส CLDR แบบ 2 อักขระ ไม่มีค่าเริ่มต้น

    หากชื่อประเทศของช่อง formattedAddress ในคำตอบตรงกับ regionCode, รหัสประเทศไม่รวมอยู่ใน formattedAddress พารามิเตอร์นี้ไม่มีผลต่อ adrFormatAddress ซึ่งจะรวมประเทศเสมอ หรือใน shortFormattedAddress ซึ่งจะไม่รวมอยู่ด้วย

    รหัส CLDR ส่วนใหญ่เหมือนกับรหัส ISO 3166-1 โดยมีข้อยกเว้นบางประการเด่นๆ ตัวอย่างเช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ในขณะที่รหัส ISO 3166-1 คือ "gb" (โดยทางเทคนิคสำหรับ นิติบุคคล "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ") พารามิเตอร์อาจส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง

  • sessionToken

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

ตัวอย่างรายละเอียดสถานที่

ตัวอย่างต่อไปนี้จะขอรายละเอียดของสถานที่โดย placeId:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

โปรดทราบว่าส่วนหัว X-Goog-FieldMask จะระบุว่า คำตอบ มีฟิลด์ข้อมูลต่อไปนี้ id,displayName การตอบกลับจะอยู่ในรูปแบบดังนี้

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

เพิ่มประเภทข้อมูลในมาสก์ของช่องเพื่อแสดงข้อมูลเพิ่มเติม ตัวอย่างเช่น เพิ่ม formattedAddress,plusCode เพื่อใส่พารามิเตอร์ ที่อยู่และ Plus Code ไว้ในส่วน คำตอบ:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

ตอนนี้การตอบกลับจะอยู่ในรูปแบบดังนี้

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

ลองใช้งาน

โปรแกรมสำรวจ API ช่วยให้คุณสามารถสร้างคำขอตัวอย่าง ที่คุณสามารถทำความคุ้นเคยกับ API และตัวเลือก API

โดยวิธีส่งคำขอมีดังนี้

  1. เลือกไอคอน API ขยายโปรแกรมสำรวจ API ที่ด้านขวาของหน้า
  2. เลือกตั้งค่าพารามิเตอร์ name เป็น วันที่
    places/PLACE_ID
  3. ขยายแสดงพารามิเตอร์มาตรฐาน (ไม่บังคับ) และตั้งค่า พารามิเตอร์ fields ในฟิลด์มาสก์
  4. เลือกปุ่มดำเนินการ ในป๊อปอัป ให้เลือกบัญชีที่คุณต้องการ ใช้ในการส่งคำขอ
  5. ในแผงโปรแกรมสำรวจ API ให้เลือกไอคอนขยาย ขยายโปรแกรมสำรวจ API เพื่อขยายหน้าต่างโปรแกรมสำรวจ API