Package google.maps.geocode.v4

ดัชนี

DestinationService

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

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

SearchDestinations

rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse)

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

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

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

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

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

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

ทางเข้า

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

ช่อง
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/{placeId} ใช้เพื่อค้นหาสถานที่ได้
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

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

TravelMode

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

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

การใช้งาน

การใช้งานที่จุดนำทางนี้รองรับ ทั้งนี้ อาจมีการเพิ่มค่าใหม่ๆ ในอนาคต

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

PlaceView

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

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

ช่อง
place

string

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

string

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