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

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

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

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

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 เหมาะสำหรับจอดรับผู้โดยสาร เช่น สถานที่ขึ้นรถของแอปเรียกรถ
PARKING เหมาะสำหรับจอดรถ เช่น ภายในลานจอดรถ

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

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

ฟิลด์ 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 รายการหากระบุปลายทางหลักจากคำค้นหาหลักได้อย่างชัดเจน ไม่เช่นนั้น บริการอาจแสดงผลลัพธ์หลายรายการเพื่อแยกความกำกวมหรือแสดงผลลัพธ์เป็น 0