ย้ายข้อมูลจากฟีเจอร์ 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