Package google.maps.geocode.v4

ดัชนี

DestinationService

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

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

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)

เมธอดนี้จะค้นหาพิกัดทางภูมิศาสตร์โดยใช้รหัสสถานที่

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

ต้องใช้ขอบเขต 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

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

ทางเข้า

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

ช่อง
display_name

LocalizedText

ชื่อที่มนุษย์อ่านได้ เช่น "ประตู B", "ทางเข้าทิศใต้", "ทางเข้าถนนสายที่ 5"
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() ต้องเป็นจุดตะวันออกเฉียงเหนือของวิวพอร์ตสี่เหลี่ยมผืนผ้า 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

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

ช่อง
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

อาร์เรย์ที่ระบุประเภทขององค์ประกอบที่อยู่

ค่าเหล่านี้ดึงมาจากตารางประเภทที่อยู่และประเภทคอมโพเนนต์ที่อยู่ที่ Places API ใช้: https://developers.google.com/maps/documentation/places/web-service/place-types#address-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

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

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

ช่อง
place

string

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

string

ตัวระบุที่ไม่ซ้ำกันของสถานที่
display_name

LocalizedText

คำอธิบายสถานที่ที่มนุษย์อ่านได้ เช่น "ประตู 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 รองรับ MultiPolygon ดังนั้นออบเจ็กต์ display_polygon 1 รายการจึงแสดงรูปหลายเหลี่ยมได้หลายรูป
address_components[]

PlaceView.AddressComponent

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

AddressComponent

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

ช่อง
long_text

string

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

string

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

string

อาร์เรย์ที่ระบุประเภทขององค์ประกอบที่อยู่

ค่าเหล่านี้ดึงมาจากตารางประเภทที่อยู่และประเภทคอมโพเนนต์ที่อยู่ที่ Places API ใช้: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types
language_code

string

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

StructureType

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

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

PlusCode

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

ช่อง
global_code

string

รหัสสากล (แบบเต็ม) ของสถานที่ เช่น "9FWM33GV+HQ" ซึ่งแสดงพื้นที่ขนาด 1/8000 คูณ 1/8000 องศา (ประมาณ 14 คูณ 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 รายการ