Package google.maps.geocode.v4alpha

ดัชนี

DestinationService

บริการสำหรับการดึงข้อมูลปลายทาง

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

SearchDestinations

rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse)

เมธอดนี้จะค้นหาปลายทางและแสดงผลรายการปลายทาง

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

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

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

GeocodeService

บริการสำหรับการเข้ารหัสพิกัดภูมิศาสตร์

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

วิธีนี้จะทำการเข้ารหัสพิกัดภูมิศาสตร์ของที่อยู่ ซึ่งจะแมปที่อยู่กับ LatLng นอกจากนี้ยังให้ข้อมูลที่มีโครงสร้างเกี่ยวกับที่อยู่ด้วย

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

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

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.address
GeocodeLocation

rpc GeocodeLocation(GeocodeLocationRequest) returns (GeocodeLocationResponse)

เมธอดนี้จะทำการเข้ารหัสพิกัดภูมิศาสตร์ของตำแหน่ง ซึ่งจะแมป LatLng กับที่อยู่ นอกจากนี้ยังให้ข้อมูลที่มีโครงสร้างเกี่ยวกับที่อยู่ด้วย

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

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

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.location
GeocodePlace

rpc GeocodePlace(GeocodePlaceRequest) returns (GeocodeResult)

เมธอดนี้จะค้นหา Geocode โดยใช้รหัสสถานที่

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

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

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.place

ปลายทาง

ปลายทาง ซึ่งรวมถึงสถานที่หลัก สถานที่ที่เกี่ยวข้อง ทางเข้า และจุดนำทาง

ช่อง
primary

PlaceView

สถานที่หลักที่ primary_query ระบุในคำขอ
containing_places[]

PlaceView

สถานที่ที่มีความแม่นยำน้อยกว่าซึ่งสถานที่หลักอยู่ เช่น กลุ่มอาคารอพาร์ตเมนต์ที่มีอาคารนี้
sub_destinations[]

PlaceView

จุดหมายย่อยที่แม่นยำยิ่งขึ้นของสถานที่หลัก เช่น ยูนิตที่อยู่ในอาคาร

หมายเหตุ: รายการจุดหมายย่อยนี้ครอบคลุมมากกว่าSubDestinationที่ Places API แสดงผล และจุดหมายย่อยแต่ละรายการมีข้อมูลมากกว่า
landmarks[]

Landmark

จุดสังเกตที่ใช้สื่อสารตำแหน่งของจุดหมายหรือช่วยในการเดินทางมาถึง
entrances[]

Entrance

ทางเข้าของจุดหมายนี้
navigation_points[]

NavigationPoint

จุดนำทางสำหรับจุดหมายนี้
arrival_summary

Destination.ArrivalSummary

ข้อมูลสรุปเกี่ยวกับประสบการณ์การเดินทางมาถึงที่จุดหมายที่ AI สร้างขึ้น

ArrivalSummary

ข้อมูลสรุปเกี่ยวกับประสบการณ์การเดินทางมาถึงที่จุดหมายที่ AI สร้างขึ้น

ช่อง
text

LocalizedText

สรุปประสบการณ์การมาถึงที่จุดหมาย
flag_content_url

string

ลิงก์ที่ผู้ใช้สามารถแจ้งปัญหาเกี่ยวกับข้อมูลสรุป
disclosure_text

LocalizedText

เอาต์พุตเท่านั้น มีข้อความการเปิดเผยข้อมูลสำหรับข้อมูลสรุปการมาถึง

ทางเข้า

ทางเข้าคือคู่พิกัดละติจูด/ลองจิจูดเดียวที่กำหนดตำแหน่งของจุดเข้าและออกของสถานที่

ช่อง
location

LatLng

ตำแหน่งของทางเข้า
tags[]

Entrance.Tag

รายการแท็กที่อธิบายทางเข้า
place

string

โครงสร้างที่ทางเข้านี้ตั้งอยู่จริงในรูปแบบ places/{place_id}

แท็ก

ลักษณะที่อธิบายทางเข้า

Enum
TAG_UNSPECIFIED ไม่ได้ใช้
PREFERRED

ทางเข้ามักจะให้สิทธิ์เข้าถึงสถานที่หลักในปลายทางที่แสดง สถานที่อาจมีทางเข้าที่แนะนำหลายแห่ง หากทางเข้าไม่มีแท็กนี้ แสดงว่าทางเข้าอยู่ในอาคารเดียวกับสถานที่หลัก แต่ไม่ได้ให้สิทธิ์เข้าถึงสถานที่นั้นเสมอไป

ตัวอย่างเช่น หากสถานที่หลักคือร้านอาหารในแหล่งรวมร้านค้า ทางเข้าที่ "ต้องการ" จะเป็นทางเข้าที่น่าจะนำไปสู่ร้านอาหารนั้นๆ โดยตรง ส่วนทางเข้าอื่นๆ ที่แสดงจะเป็นทางเข้าอื่นๆ ของอาคาร เช่น ทางเข้าของร้านอาหารอื่นๆ ในแหล่งรวมร้านค้า

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

หมายเหตุ: PREFERREDทางเข้าอาจไม่ได้ให้สิทธิ์เข้าถึงสถานที่หลัก และทางเข้าที่ไม่ใช่PREFERREDอาจให้สิทธิ์เข้าถึงสถานที่หลัก

GeocodeAddressRequest

ข้อความคำขอสำหรับ GeocodeService.GeocodeAddress

ช่อง
location_bias

GeocodeAddressRequest.LocationBias

ไม่บังคับ ภูมิภาคที่จะค้นหา ตำแหน่งนี้จะเป็นตำแหน่งที่ให้น้ำหนักพิเศษ ซึ่งหมายความว่าระบบอาจแสดงผลลัพธ์รอบๆ ตำแหน่งที่ระบุ
language_code

string

ไม่บังคับ ภาษาที่ควรแสดงผลลัพธ์
region_code

string

ไม่บังคับ รหัสภูมิภาค รหัสภูมิภาคที่ระบุเป็นค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") พารามิเตอร์นี้ส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง พารามิเตอร์นี้จะส่งผลต่อผลลัพธ์จากบริการด้วย แต่จะไม่จำกัดผลลัพธ์โดยสมบูรณ์
ฟิลด์ Union address_input ที่อยู่ที่ต้องการเข้ารหัสพิกัดภูมิศาสตร์ address_input ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
address_query

string

ที่อยู่ที่ไม่มีโครงสร้างที่จะเข้ารหัสพิกัดภูมิศาสตร์
address

PostalAddress

ที่อยู่ที่มีโครงสร้างที่จะเข้ารหัสพิกัดภูมิศาสตร์ในรูปแบบที่อยู่ไปรษณีย์

LocationBias

ภูมิภาคที่จะค้นหา ตำแหน่งนี้จะเป็นตำแหน่งที่ให้น้ำหนักพิเศษ ซึ่งหมายความว่าระบบอาจแสดงผลลัพธ์รอบๆ ตำแหน่งที่ระบุ

ช่อง
ฟิลด์ Union type ประเภทของอคติทางภูมิศาสตร์ type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
rectangle

Viewport

กล่องสี่เหลี่ยมผืนผ้าที่กำหนดโดยมุมตะวันออกเฉียงเหนือและตะวันตกเฉียงใต้ rectangle.high() ต้องเป็นจุดทางตะวันออกเฉียงเหนือของ Viewport สี่เหลี่ยมผืนผ้า rectangle.low() ต้องเป็นจุดทางตะวันตกเฉียงใต้ของวิวพอร์ตสี่เหลี่ยมผืนผ้า rectangle.low().latitude() ต้องไม่เกิน rectangle.high().latitude() ซึ่งจะส่งผลให้ช่วงละติจูดว่างเปล่า วิวพอร์ตสี่เหลี่ยมผืนผ้าต้องกว้างไม่เกิน 180 องศา

GeocodeAddressResponse

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

ช่อง
results[]

GeocodeResult

ผลการเข้ารหัสพิกัดภูมิศาสตร์

GeocodeLocationRequest

ข้อความคำขอสำหรับ GeocodeService.GeocodeLocation

ช่อง
language_code

string

ไม่บังคับ ภาษาที่ควรแสดงผลลัพธ์
region_code

string

ไม่บังคับ รหัสภูมิภาค รหัสภูมิภาคที่ระบุเป็นค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") พารามิเตอร์นี้ส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง
types[]

string

ไม่บังคับ ชุดแท็กประเภทเพื่อจำกัดผลลัพธ์ ระบบจะนำผลลัพธ์ที่ไม่มีประเภทที่ระบุออก

ดูรายการค่าที่เป็นไปได้ทั้งหมดได้ที่ตาราง A และตาราง B ใน https://developers.google.com/maps/documentation/places/web-service/place-types
granularity[]

GeocodeResult.Granularity

ไม่บังคับ ตัวกรองของ Enum ความละเอียดของสถานที่อย่างน้อย 1 รายการ
ฟิลด์ Union location_input สถานที่ตั้งที่จะเข้ารหัสพิกัดภูมิศาสตร์ location_input ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
location_query

string

ตำแหน่งในรูปแบบสตริง "lat,lng" เช่น "64.7611872,-18.4705364"
location

LatLng

สถานที่ตั้งในรูปแบบที่มีโครงสร้าง

GeocodeLocationResponse

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

ช่อง
results[]

GeocodeResult

ผลการเข้ารหัสพิกัดภูมิศาสตร์
plus_code

PlusCode

Plus Code ของสถานที่ตั้งในคำขอ

GeocodePlaceRequest

ข้อความคำขอสำหรับ GeocodeService.GeocodePlace

ช่อง
place

string

ต้องระบุ ตัวระบุสถานที่ที่จะแปลงรหัสพิกัดภูมิศาสตร์ในรูปแบบ places/{place}
language_code

string

ไม่บังคับ ภาษาที่ควรแสดงผลลัพธ์
region_code

string

ไม่บังคับ รหัสภูมิภาค รหัสภูมิภาคที่ระบุเป็นค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") พารามิเตอร์นี้ส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง

GeocodeResult

ผลลัพธ์ของ Geocode มีข้อมูลทางภูมิศาสตร์เกี่ยวกับสถานที่

ช่อง
place

string

ตัวระบุสถานที่ที่สมบูรณ์สำหรับผลลัพธ์นี้ ในรูปแบบ "//places.googleapis.com/places/{placeID}" ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/documentation/places/web-service/place-id
place_id

string

รหัสสถานที่สำหรับผลการค้นหานี้
location

LatLng

ละติจูด ลองจิจูดของที่อยู่นี้
granularity

GeocodeResult.Granularity

ความละเอียดของตำแหน่ง
viewport

Viewport

วิวพอร์ตที่เหมาะสําหรับการแสดงผลลัพธ์การเข้ารหัสพิกัดภูมิศาสตร์
bounds

Viewport

กรอบเขตสำหรับที่อยู่
formatted_address

string

ที่อยู่ที่จัดรูปแบบเป็นบรรทัดเดียว
postal_address

PostalAddress

ที่อยู่ในรูปแบบที่อยู่ทางไปรษณีย์
address_components[]

GeocodeResult.AddressComponent

คอมโพเนนต์ที่ซ้ำกันสำหรับระดับสถานที่แต่ละระดับ
postal_code_localities[]

LocalizedText

รายการสถานที่ทั้งหมดที่อยู่ในรหัสไปรษณีย์

ระบบจะป้อนข้อมูลนี้เมื่อผลลัพธ์เป็นประเภท "postal_code" เท่านั้น
types[]

string

ชุดแท็กประเภทสำหรับผลการค้นหานี้ เช่น "political" และ "administrative_area"

ดูรายการค่าที่เป็นไปได้ทั้งหมดได้ที่ตาราง A และตาราง B ใน https://developers.google.com/maps/documentation/places/web-service/place-types
plus_code

PlusCode

Plus Code ของสถานที่ตั้งในการเข้ารหัสพิกัดภูมิศาสตร์นี้

AddressComponent

คอมโพเนนต์ที่มีโครงสร้างซึ่งประกอบกันเป็นที่อยู่ที่จัดรูปแบบแล้ว หากมีข้อมูลนี้

ช่อง
long_text

string

คำอธิบายข้อความหรือชื่อแบบเต็มของคอมโพเนนต์ที่อยู่ เช่น คอมโพเนนต์ที่อยู่สำหรับประเทศออสเตรเลียอาจมีชื่อแบบยาวว่า "ออสเตรเลีย"
short_text

string

ชื่อข้อความแบบย่อของคอมโพเนนต์ที่อยู่ (หากมี) ตัวอย่างเช่น คอมโพเนนต์ที่อยู่สำหรับประเทศออสเตรเลียอาจมีชื่อย่อเป็น "AU"
types[]

string

อาร์เรย์ที่ระบุประเภทของคอมโพเนนต์ที่อยู่

ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types
language_code

string

ภาษาที่ใช้ในการจัดรูปแบบคอมโพเนนต์นี้ในรูปแบบ CLDR

รายละเอียด

ความละเอียดของตำแหน่ง

Enum
GRANULARITY_UNSPECIFIED โปรดอย่าใช้
ROOFTOP ตำแหน่งที่ไม่ได้ประมาณค่าของแปลงที่ดินจริงซึ่งตรงกับที่อยู่ที่ตรงกัน
RANGE_INTERPOLATED ประมาณค่าจากช่วงหมายเลขถนน เช่น หากเรารู้ว่าส่วนหนึ่งของ Amphitheatre Pkwy มีหมายเลข 1600-1699 เราอาจวางหมายเลข 1650 ไว้กึ่งกลางระหว่างจุดสิ้นสุด
GEOMETRIC_CENTER จุดศูนย์กลางทางเรขาคณิตของฟีเจอร์ที่เรามีข้อมูลรูปหลายเหลี่ยม
APPROXIMATE อื่นๆ ทั้งหมด

สถานที่สำคัญ

ระบบจะใช้จุดสังเกตเพื่อสื่อสารว่าจุดหมายอยู่ที่ใดหรือช่วยให้ไปถึงจุดหมาย

ช่อง
relational_description

LocalizedText

คำอธิบายที่มนุษย์อ่านได้ว่าจุดหมายเกี่ยวข้องกับสถานที่สำคัญอย่างไร เช่น "ใกล้ตึกเอ็มไพร์สเตต" หรือ "ตรงข้ามทำเนียบขาว"
tags[]

Landmark.Tag

แท็กที่อธิบายวิธีใช้สถานที่สำคัญในบริบทของจุดหมาย
straight_line_distance_meters

double

เอาต์พุตเท่านั้น ระยะทางเป็นเส้นตรงจากสถานที่สำคัญนี้ไปยังจุดหมายปลายทางเป็นเมตร
travel_distance_meters

double

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

PlaceView

สถานที่ที่แสดงถึงสถานที่สำคัญนี้

แท็ก

รายการแท็กทั้งหมดที่เป็นไปได้ซึ่งอธิบายวิธีใช้สถานที่สำคัญในบริบทของจุดหมาย

หากที่อยู่มีทั้งแท็ก ADDRESS และ ARRIVAL แสดงว่าสถานที่สำคัญนั้นโดดเด่นในพื้นที่และอยู่ใกล้กับจุดหมาย

Enum
TAG_UNSPECIFIED ไม่ได้ใช้
ADDRESS สถานที่ที่มีชื่อเสียงในท้องถิ่นซึ่งใช้ระบุตำแหน่งทั่วไปของปลายทางได้ โดยปกติจะอยู่ภายในรัศมีไม่กี่ร้อยเมตรจากจุดหมาย ซึ่งคล้ายกับสถานที่สำคัญที่ฟีเจอร์ตัวอธิบายที่อยู่ของ Geocoding API แสดงผล: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors
ARRIVAL สถานที่ที่ใช้ช่วยให้ไปถึงจุดหมายได้ มีประโยชน์สำหรับการนำทางเมื่อคุณอยู่ใกล้จุดหมาย เช่น สถานที่สำคัญนี้อาจเป็นสถานที่ที่อยู่ฝั่งตรงข้ามถนนจากจุดหมาย โดยปกติแล้ว สถานที่สำคัญที่มีแท็กนี้จะอยู่ใกล้กับจุดหมายปลายทางมากกว่าสถานที่สำคัญที่มีแท็ก ADDRESS

จุดนำทางคือสถานที่ที่อยู่ข้างถนนซึ่งการนำทางสามารถสิ้นสุดได้

ช่อง
navigation_point_token

string

เอาต์พุตเท่านั้น โทเค็นที่ใช้ระบุจุดนำทางนี้ได้
display_name

LocalizedText

ชื่อที่แสดงของจุดนำทางนี้ เช่น "5th Ave" หรือ "Gate B"
location

LatLng

จุดที่อยู่ข้างส่วนของถนนที่ควรสิ้นสุดการนำทาง จุดนี้ตั้งใจให้เบี่ยงออกจากเส้นกึ่งกลางของถนนเล็กน้อยเพื่อทำเครื่องหมายด้านข้างของถนนที่สถานที่ตั้งอยู่อย่างชัดเจน
travel_modes[]

NavigationPoint.TravelMode

โหมดการเดินทางที่เหมาะสมกับจุดนำทางนี้
usages[]

NavigationPoint.Usage

การใช้งานที่จุดนำทางนี้รองรับ

TravelMode

โหมดการเดินทางที่เหมาะสมกับจุดนำทางนี้

Enum
TRAVEL_MODE_UNSPECIFIED ไม่ได้ใช้
DRIVE เหมาะสำหรับการขับขี่
WALK เหมาะกับการเดิน

การใช้งาน

การใช้งานที่จุดนำทางนี้รองรับ

Enum
USAGE_UNSPECIFIED ไม่ได้ใช้
UNKNOWN ประเภทการใช้งานที่ไม่รู้จัก จุดนำทางส่วนใหญ่จะเป็น UNKNOWN และไม่ได้หมายความว่าการใช้งานจะถูกจำกัดในทางใดทางหนึ่ง การนำทางนี้อาจยังเหมาะสำหรับการรับและ/หรือส่งสินค้า
DROPOFF เหมาะสำหรับการส่งผู้โดยสาร เช่น สถานที่ส่งผู้โดยสารของบริการเรียกรถ
PICKUP เหมาะสำหรับการรับผู้โดยสาร เช่น สถานที่ขึ้นรถร่วมเดินทาง

PlaceView

แสดงมุมมองของ Place ใน Places API นอกจากนี้ ยังให้ข้อมูลเพิ่มเติมที่เฉพาะเจาะจงสำหรับจุดหมาย เช่น ประเภทโครงสร้างและรูปหลายเหลี่ยมที่แสดง

ในบางกรณี PlaceView ที่มีรหัสสถานที่เดียวกันอาจแตกต่างจากที่ Places API แสดงผลสำหรับฟิลด์ types และ display_name

ช่อง
place

string

ชื่อทรัพยากรของสถานที่นี้ในรูปแบบ places/{placeId}
display_name

LocalizedText

คำอธิบายสถานที่ที่มนุษย์อ่านได้ เช่น "Gate B", "McDonalds"
primary_type

string

ประเภทสถานที่หลักของสถานที่นี้ ดูรายการค่าที่เป็นไปได้ได้ที่ https://developers.google.com/maps/documentation/places/web-service/place-types

หมายเหตุ: ระบบอาจไม่ป้อนข้อมูลในช่องนี้เสมอไป เตรียมพร้อมที่จะใช้ฟิลด์ types ในสถานการณ์ดังกล่าว
types[]

string

ประเภทสถานที่ที่เชื่อมโยงทั้งหมดของสถานที่นี้ ดูรายการค่าที่เป็นไปได้ได้ที่ https://developers.google.com/maps/documentation/places/web-service/place-types
formatted_address

string

ที่อยู่แบบบรรทัดเดียว
postal_address

PostalAddress

ที่อยู่ที่มีโครงสร้าง
structure_type

PlaceView.StructureType

ประเภทโครงสร้างที่สอดคล้องกับสถานที่นี้
location

LatLng

สถานที่ตั้งของสถานที่นี้ สำหรับสถานที่ที่มีรูปหลายเหลี่ยมแสดงผล นี่อาจเป็นจุดที่เหมาะแก่การวางเครื่องหมายบนแผนที่
display_polygon

Struct

เส้นขอบรูปหลายเหลี่ยมของสถานที่ในรูปแบบ GeoJSON โดยใช้รูปแบบ RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6

หมายเหตุ: รูปแบบ RFC 7946 รองรับ MultiPolygons ดังนั้นdisplay_polygonออบเจ็กต์หนึ่งรายการจึงแสดงรูปหลายเหลี่ยมได้หลายรายการ

StructureType

ประเภทโครงสร้างที่สถานที่นี้แสดง

Enum
STRUCTURE_TYPE_UNSPECIFIED ไม่ได้ใช้
POINT ตำแหน่งจุด
SECTION ส่วนย่อยของอาคาร
BUILDING อาคาร
GROUNDS พื้นที่ขนาดใหญ่ซึ่งมักจะมีอาคารหลายหลัง เช่น มหาวิทยาลัย อาคารอพาร์ตเมนต์ หรือห้างสรรพสินค้า

PlusCode

Plus Code (http://plus.codes) คือการอ้างอิงตำแหน่งที่มี 2 รูปแบบ ได้แก่ รหัสสากลที่กำหนดสี่เหลี่ยมผืนผ้าขนาด 14x14 เมตร (1/8000 ขององศา) หรือเล็กกว่า และรหัสผสมที่แทนที่คำนำหน้าด้วยตำแหน่งอ้างอิง

ช่อง
global_code

string

รหัสสากล (แบบเต็ม) ของสถานที่ เช่น "9FWM33GV+HQ" ซึ่งแสดงพื้นที่ขนาด 1/8000 x 1/8000 องศา (~14 x 14 เมตร)
compound_code

string

รหัสผสมของสถานที่ เช่น "33GV+HQ, Ramberg, Norway" ซึ่งมีคำต่อท้ายของรหัสสากลและแทนที่คำนำหน้าด้วยชื่อที่จัดรูปแบบของเอนทิตีอ้างอิง

SearchDestinationsRequest

ข้อความคำขอสำหรับ DestinationService.SearchDestinations

ช่อง
travel_modes[]

NavigationPoint.TravelMode

ไม่บังคับ โหมดการเดินทางที่จะใช้กรองจุดนำทาง ซึ่งจะส่งผลต่อฟิลด์ navigation_points ที่แสดงในคำตอบ หากเว้นว่าง ระบบจะแสดงผลจุดนำทางของรูปแบบการเดินทางทั้งหมด
language_code

string

ไม่บังคับ ภาษาที่ควรแสดงผลลัพธ์
region_code

string

ไม่บังคับ รหัสภูมิภาค รหัสภูมิภาคที่ระบุเป็นค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") พารามิเตอร์นี้ส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง พารามิเตอร์นี้ยังส่งผลต่อผลลัพธ์จากบริการด้วย แต่จะไม่จำกัดผลลัพธ์โดยสมบูรณ์

ฟิลด์ Union primary_query ค้นหาจุดหมายหลัก ซึ่งอาจเป็นสถานที่ ที่อยู่ที่ระบุแบบเต็ม หรือตำแหน่ง LatLng สถานที่และที่อยู่บางแห่งที่มีข้อมูลน้อยที่สุดจะเปลี่ยนเป็นปลายทางไม่ได้

ระบบจะสร้างปลายทางตามคำค้นหาหลักที่ระบุ

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

string

ชื่อทรัพยากรของสถานที่ในรูปแบบ places/{place_id}
address_query

SearchDestinationsRequest.AddressQuery

ที่อยู่
location_query

SearchDestinationsRequest.LocationQuery

ตำแหน่งที่แน่นอน

AddressQuery

ที่อยู่ที่ต้องการค้นหา ระบุที่อยู่ตามรูปแบบที่ใช้โดยบริการไปรษณีย์แห่งชาติของประเทศที่เกี่ยวข้อง

ช่อง
ฟิลด์ Union kind การค้นหาที่อยู่ kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
address

PostalAddress

ที่อยู่ในรูปแบบที่อยู่ทางไปรษณีย์
address_query

string

ที่อยู่ที่จัดรูปแบบเป็นบรรทัดเดียว

LocationQuery

การค้นหาสถานที่เพื่อระบุจุดหมายหลักที่อยู่ใกล้เคียง

หมายเหตุ: หากการค้นหาสถานที่อยู่ภายในอาคารที่มีสถานที่ย่อย สถานที่หลักที่แสดงอาจเป็นสถานที่ย่อย ในกรณีเหล่านี้ ฟิลด์ containing_places จะรวมอาคารไว้ด้วย

ช่อง
place_filter

SearchDestinationsRequest.LocationQuery.PlaceFilter

ไม่บังคับ ตัวกรองที่จะใช้กับผู้สมัครรับเลือกเป็นปลายทาง
ฟิลด์ Union kind การค้นหาสถานที่ kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
location

LatLng

ตำแหน่ง LatLng ที่แน่นอน

PlaceFilter

ตัวกรองที่จะใช้กับผู้สมัครรับเลือกเป็นปลายทาง

ช่อง
structure_type

PlaceView.StructureType

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

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

การใช้ฟิลด์นี้อีกอย่างหนึ่งคือการดึงรูปหลายเหลี่ยมของอาคารที่แสดงได้ง่ายขึ้น เช่น หากระบุ BUILDING รูปหลายเหลี่ยมที่แสดงของสถานที่หลักจะเป็นของอาคารในสถานที่ที่ระบุ
addressability

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

ไม่บังคับ หากระบุไว้ จะแสดงเฉพาะปลายทางที่ตรงตามเกณฑ์การระบุแหล่งที่มาที่เกี่ยวข้อง

การกำหนดเป้าหมาย

กำหนดตัวเลือกสำหรับการกรองการกำหนดเป้าหมาย ทั้งนี้ อาจมีการเพิ่มค่าใหม่ๆ ในอนาคต

Enum
ADDRESSABILITY_UNSPECIFIED หากไม่ได้ระบุ บริการจะเลือกค่าเริ่มต้นที่เหมาะสม
ANY การกำหนดเป้าหมายไม่ใช่เกณฑ์การกรอง ระบบจะแสดงผลปลายทางโดยไม่คำนึงถึงความสามารถในการระบุที่อยู่
PRIMARY ปลายทางทั้งหมดที่แสดงจะมีสถานที่หลักที่มีที่อยู่หรือชื่อระดับถนน
WEAK ปลายทางทั้งหมดที่แสดงจะมีสถานที่หลักหรือปลายทางย่อยที่มีที่อยู่หรือชื่อระดับถนน

SearchDestinationsResponse

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

ช่อง
destinations[]

Destination

รายการปลายทาง

บริการจะแสดงผลลัพธ์ 1 รายการหากระบุปลายทางหลักจากคำค้นหาหลักได้อย่างชัดเจน ไม่เช่นนั้น บริการอาจแสดงผลลัพธ์หลายรายการเพื่อแยกความแตกต่าง หรือไม่แสดงผลลัพธ์เลย