ย้ายข้อมูลจากฟีเจอร์ v3 ไปยังปลายทาง SearchDestinations

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

เราจะแทนที่ฟีเจอร์ต่อไปนี้ใน Geocoding API v3 ด้วยปลายทาง SearchDestinations ของ Geocoding API v4

  • การเข้าชม
  • จุดนำทาง
  • การสร้างโครงร่าง
  • ค่าเข้า

หากคุณใช้ Geocoding API v3 สำหรับฟีเจอร์ข้างต้น โปรดใช้เอกสารนี้ เพื่อช่วยให้คุณใช้ปลายทาง SearchDestinations แทนเพื่อรับฟีเจอร์เหล่านี้ เอกสารนี้จะอธิบายตำแหน่งในคำตอบของ SearchDestinations API ที่จะพบฟีเจอร์เหล่านี้ รวมถึงความแตกต่างของวิธีแสดงฟีเจอร์เหล่านี้ในคำตอบของ API ระหว่าง Geocoding API v3 กับปลายทาง SearchDestinations ของ Geocoding API v4

การเข้าชม

หากต้องการรับทางเข้าที่เชื่อมโยงกับ destination ให้ใช้ฟิลด์ destination.entrances

โปรดทราบว่ารูปแบบของ entrance จะแตกต่างจาก รูปแบบทางเข้าใน Geocoding API v3 เล็กน้อย ทางเข้าแต่ละแห่งใน destination.entrances มีฟิลด์ต่อไปนี้

  • displayName - นี่คือฟิลด์ใหม่ที่ไม่บังคับซึ่งจะมีชื่อที่มนุษย์อ่านได้ สำหรับทางเข้า เช่น "ประตู B"
  • location - นี่คือสถานที่ตั้งประเภท LatLng ซึ่งแตกต่างจากรูปแบบที่ใช้ใน Geocoding API v3
  • tags - เหมือนกับฟิลด์ tags ของทางเข้าจาก Geocoding API v3
  • place - เทียบเท่ากับฟิลด์ buildingPlaceId ของทางเข้าจาก Geocoding API v3 อย่างไรก็ตาม รหัสสถานที่ในฟิลด์นี้อาจเป็นรหัสสถานที่ประเภทใดก็ได้ ไม่จำเป็นต้องเป็นอาคารเท่านั้น

หากต้องการรับจุดนำทางที่เชื่อมโยงกับ destination ให้ใช้ฟิลด์ destination.navigationPoints

โปรดทราบว่ารูปแบบของ navigationPoint จะแตกต่างจาก รูปแบบจุดนำทางใน Geocoding API v3 เล็กน้อย จุดนำทางแต่ละจุดใน destination.navigationPoints มีฟิลด์ต่อไปนี้

  • displayName - นี่คือฟิลด์ใหม่ที่ไม่บังคับซึ่งจะมีชื่อที่มนุษย์อ่านได้ สำหรับจุดนำทาง เช่น "5th Ave"
  • location - นี่คือสถานที่ตั้งประเภท LatLng ซึ่งแตกต่างจากรูปแบบที่ใช้ใน Geocoding API v3
  • travelModes - ซึ่งคล้ายกับฟิลด์ restrictedTravelModes ของ จุดนำทางจาก Geocoding API v3 ค่า Enum ที่เป็นไปได้จะเหมือนกัน ความแตกต่างเพียงอย่างเดียวคือตอนนี้ฟิลด์นี้แสดงถึงรูปแบบการเดินทางที่ยอมรับได้สำหรับจุดนำทาง แทนที่จะเป็นรูปแบบการเดินทางที่ถูกจำกัด
  • usage - นี่คือฟิลด์ใหม่ที่มีกรณีการใช้งานที่จุดนำทางรองรับ โปรดทราบว่าจุดนำทางส่วนใหญ่จะมีUNKNOWNการใช้งาน แต่ไม่ได้หมายความว่าการใช้งานจุดนำทางจะถูกจำกัดใน ทางใดทางหนึ่ง

การสร้างโครงร่าง

หากต้องการรับโครงร่างอาคารที่เชื่อมโยงกับ destination คุณควร ใช้ฟิลด์ displayPolygon ของออบเจ็กต์ placeView ใน destination ที่แสดงถึงอาคาร สำหรับแต่ละ placeView คุณสามารถตรวจสอบว่าเป็นอาคารหรือไม่ด้วยฟิลด์ placeView.structureType หากประเภทโครงสร้างเป็น BUILDING คุณจะดูโครงร่างได้จากฟิลด์ placeView.displayPolygon placeView จะมีฟิลด์เพิ่มเติมสำหรับอาคารที่ไม่ได้อยู่ใน Geocoding API v3 ด้วย

destination อาจมีออบเจ็กต์ placeView ที่แสดงอาคารในฟิลด์ต่อไปนี้

  • destination.primary - นี่คือสถานที่หลักของปลายทาง
  • destination.containingPlaces - นี่คือฟิลด์ที่ซ้ำได้ซึ่งสามารถ เก็บสถานที่ขนาดใหญ่กว่าที่ "มี" สถานที่หลัก เช่น หากสถานที่หลักคือ subpremise โดยปกติแล้ว containingPlaces จะมี placeView ซึ่งแสดงถึงอาคาร
  • destination.subDestinations - นี่คือฟิลด์ที่ซ้ำได้ซึ่งมี สถานที่ย่อยของสถานที่หลัก เช่น อพาร์ตเมนต์แต่ละยูนิตในอาคาร โดยปกติแล้วฟิลด์นี้จะไม่มี placeView ที่แสดงถึง อาคาร

โปรดทราบว่ารูปแบบของ placeView.displayPolygon ตรงกับ รูปแบบขอบเขตอาคารใน Geocoding API v3 ซึ่งเป็นรูปแบบ GeoJSON โดยใช้ รูปแบบ RFC 7946

ค่าเข้า

เช่นเดียวกับการสร้างขอบเขตอาคาร หากต้องการรับพื้นที่ที่เชื่อมโยงกับ destination คุณควรใช้ฟิลด์ displayPolygon ของออบเจ็กต์ placeView ใน destination ที่แสดงถึงพื้นที่ สำหรับแต่ละ placeView คุณ สามารถตรวจสอบได้ว่ามีเหตุผลด้วยฟิลด์ placeView.structureType หรือไม่ หากประเภทโครงสร้างเป็น GROUNDS คุณจะดูโครงร่างได้จากฟิลด์ placeView.displayPolygon placeView จะมีฟิลด์เพิ่มเติมสำหรับเหตุผลที่ไม่ได้อยู่ใน Geocoding API v3 ด้วย

destination อาจมีออบเจ็กต์ placeView ที่แสดงถึงเหตุผลในฟิลด์ต่อไปนี้

  • destination.primary
  • destination.containingPlaces
  • destination.subDestinations

โปรดทราบว่ารูปแบบของ placeView.displayPolygon ตรงกับ รูปแบบโครงร่างของพื้นที่ใน Geocoding API v3 ซึ่งเป็นรูปแบบ GeoJSON โดยใช้ รูปแบบ RFC 7946

ใช้มาสก์ฟิลด์เพื่อขอฟีเจอร์เหล่านี้

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

curl -X POST -d '{"place": "places/ChIJG3kh4hq6j4AR_XuFQnV0_t8"}' \
  -H "X-Goog-Api-Key: API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Goog-FieldMask: destinations.entrances,destinations.navigationPoints,destinations.primary,destinations.containingPlaces,destinations.subDestinations" \
  https://geocode.googleapis.com/v4alpha/geocode/destinations