Geocoder

Geocoder class

google.maps.Geocoder ชั้นเรียน

บริการสำหรับแปลงที่อยู่เป็น LatLng และแปลง LatLng เป็นที่อยู่

เข้าถึงได้โดยโทรไปที่ const {Geocoder} = await google.maps.importLibrary("geocoding")
ดูไลบรารีใน Maps JavaScript API

ผู้ผลิต
Geocoder	Geocoder() พารามิเตอร์: ไม่มี สร้างอินสแตนซ์ใหม่ของ Geocoder ที่ส่งคำขอ Geocode ไปยังเซิร์ฟเวอร์ของ Google

เมธอด
geocode	geocode(request[, callback]) พารามิเตอร์:  request:  GeocoderRequest callback:  function(Array<GeocoderResult> optional, GeocoderStatus): void optional ค่าที่ส่งคืน:  Promise<GeocoderResponse> ระบุพิกัดภูมิศาสตร์ของคำขอ

GeocoderRequest อินเทอร์เฟซ

google.maps.GeocoderRequest อินเทอร์เฟซ

ข้อกำหนดสำหรับคำขอ Geocoding ที่จะส่งไปยัง Geocoder

พร็อพเพอร์ตี้
address optional	ประเภท:  string optional ที่อยู่ที่ต้องการเข้ารหัสพิกัดภูมิศาสตร์ ต้องระบุ address, location และ placeId อย่างใดอย่างหนึ่งเท่านั้น
bounds optional	ประเภท:  LatLngBounds|LatLngBoundsLiteral optional LatLngBounds ที่จะค้นหา ไม่บังคับ
componentRestrictions optional	ประเภท:  GeocoderComponentRestrictions optional โดยใช้คอมโพเนนต์เพื่อจำกัดผลลัพธ์ให้อยู่ในพื้นที่ที่เฉพาะเจาะจง ตัวกรองประกอบด้วยรายการต่อไปนี้อย่างน้อย 1 รายการ route, locality, administrativeArea, postalCode, country ระบบจะแสดงเฉพาะผลการค้นหาที่ตรงกับตัวกรองทั้งหมด ค่าตัวกรองรองรับวิธีการแก้ไขการสะกดและการจับคู่บางส่วนแบบเดียวกับคำขอ Geocoding อื่นๆ ไม่บังคับ
extraComputations optional	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น ประเภท:  Array<ExtraGeocodeComputation> optional รายการการคำนวณเพิ่มเติมที่อาจใช้เพื่อดำเนินการตามคำขอ หมายเหตุ: การคำนวณเพิ่มเติมเหล่านี้อาจแสดงช่องเพิ่มเติมในการตอบกลับ
fulfillOnZeroResults optional	ประเภท:  boolean optional ทำตามสัญญาในสถานะ ZERO_RESULT ในการตอบกลับ ซึ่งอาจเป็นสิ่งที่ต้องการเนื่องจากแม้จะไม่มีผลการแปลงรหัสพิกัดภูมิศาสตร์ แต่ก็อาจยังมีช่องระดับการตอบกลับเพิ่มเติมที่แสดง
language optional	ประเภท:  string optional ตัวระบุภาษาสำหรับภาษาที่ควรแสดงผลลัพธ์ หากเป็นไปได้ ดูรายการภาษาที่รองรับ
location optional	ประเภท:  LatLng|LatLngLiteral optional LatLng (หรือ LatLngLiteral) ที่จะค้นหา โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์จะทำการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ ดูข้อมูลเพิ่มเติมได้ที่ การแปลงพิกัดทางภูมิศาสตร์ย้อนกลับ ต้องระบุ address, location และ placeId อย่างใดอย่างหนึ่งเท่านั้น
placeId optional	ประเภท:  string optional รหัสสถานที่ที่เชื่อมโยงกับสถานที่ตั้ง รหัสสถานที่จะระบุสถานที่ในฐานข้อมูล Google Places และใน Google Maps โดยไม่ซ้ำกัน ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ในคู่มือนักพัฒนาซอฟต์แวร์ Places API โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์จะทำการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ ดูข้อมูลเพิ่มเติมได้ที่การแปลงพิกัดทางภูมิศาสตร์ย้อนกลับ ต้องระบุ address, location และ placeId อย่างใดอย่างหนึ่งเท่านั้น
region optional	ประเภท:  string optional รหัสประเทศที่ใช้เพื่อเอนเอียงการค้นหา โดยระบุเป็นแท็กย่อยภูมิภาค Unicode 2 อักขระ (ไม่ใช่ตัวเลข) / ตัวระบุ CLDR ไม่บังคับ ดูภูมิภาคที่รองรับได้ที่รายละเอียดความครอบคลุมของ Google Maps Platform

GeocoderComponentRestrictions อินเทอร์เฟซ

google.maps.GeocoderComponentRestrictions อินเทอร์เฟซ

GeocoderComponentRestrictions แสดงชุดตัวกรองที่ระบุพื้นที่ที่เฉพาะเจาะจง โปรดดูรายละเอียดเกี่ยวกับวิธีการทำงานนี้ที่ การกรองคอมโพเนนต์ Geocoding

พร็อพเพอร์ตี้
administrativeArea optional	ประเภท:  string optional ตรงกับ administrative_area levels ทั้งหมด ไม่บังคับ
country optional	ประเภท:  string optional ตรงกับชื่อประเทศหรือรหัสประเทศ 2 ตัวอักษร ISO 3166-1 ไม่บังคับ
locality optional	ประเภท:  string optional จับคู่กับทั้งประเภท locality และ sublocality ไม่บังคับ
postalCode optional	ประเภท:  string optional ตรงกับ postal_code และ postal_code_prefix ไม่บังคับ
route optional	ประเภท:  string optional ตรงกับชื่อแบบยาวหรือแบบสั้นของ route ไม่บังคับ

ExtraGeocodeComputation ค่าคงที่

google.maps.ExtraGeocodeComputation ค่าคงที่

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น

การคำนวณเพิ่มเติมที่จะดำเนินการขณะประมวลผลคำขอ Geocoding

เข้าถึงได้โดยโทรไปที่ const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding")
ดูไลบรารีใน Maps JavaScript API

ค่าคงที่
ADDRESS_DESCRIPTORS	สร้างตัวอธิบายที่อยู่

GeocoderStatus ค่าคงที่

google.maps.GeocoderStatus ค่าคงที่

สถานะที่ Geocoder ส่งกลับเมื่อการโทรไปยัง geocode() เสร็จสมบูรณ์ ระบุค่าเหล่านี้ตามค่าหรือโดยใช้ชื่อของค่าคงที่ เช่น 'OK' หรือ google.maps.GeocoderStatus.OK

เข้าถึงได้โดยโทรไปที่ const {GeocoderStatus} = await google.maps.importLibrary("geocoding")
ดูไลบรารีใน Maps JavaScript API

ค่าคงที่
ERROR	เกิดปัญหาในการติดต่อกับเซิร์ฟเวอร์ของ Google
INVALID_REQUEST	GeocoderRequest นี้ไม่ถูกต้อง
OK	การตอบกลับมี GeocoderResponse ที่ถูกต้อง
OVER_QUERY_LIMIT	หน้าเว็บส่งคำขอเกินขีดจำกัดในระยะเวลาอันสั้น
REQUEST_DENIED	หน้าเว็บไม่ได้รับอนุญาตให้ใช้ Geocoder
UNKNOWN_ERROR	ประมวลผลคำขอ Geocoding ไม่ได้เนื่องจากข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ คำขออาจสำเร็จหากคุณลองอีกครั้ง
ZERO_RESULTS	ไม่พบผลลัพธ์สำหรับ GeocoderRequest นี้

GeocoderResponse interface

google.maps.GeocoderResponse อินเทอร์เฟซ

การตอบกลับของ Geocoder ที่ Geocoder แสดงผลซึ่งมีรายการ GeocoderResult

พร็อพเพอร์ตี้
results	ประเภท:  Array<GeocoderResult> รายการ GeocoderResult
address_descriptor optional	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น ประเภท:  AddressDescriptor optional คำอธิบายเชิงสัมพันธ์ของสถานที่ ประกอบด้วยชุดจุดสังเกตที่อยู่ใกล้เคียงซึ่งจัดอันดับไว้และพื้นที่ที่มีสถานที่เป้าหมาย โดยจะระบุข้อมูลสำหรับคำขอ Geocoding แบบย้อนกลับเท่านั้น และจะระบุเมื่อเปิดใช้ ExtraGeocodeComputation.ADDRESS_DESCRIPTORS เท่านั้น
plus_code optional	ประเภท:  PlacePlusCode optional Plus Code ที่เชื่อมโยงกับสถานที่

GeocoderResult อินเทอร์เฟซ

google.maps.GeocoderResult อินเทอร์เฟซ

ผลลัพธ์ Geocoder รายการเดียวที่ดึงมาจากเซิร์ฟเวอร์ Geocode คำขอ Geocode อาจแสดงออบเจ็กต์ผลลัพธ์หลายรายการ โปรดทราบว่าแม้ผลลัพธ์นี้จะ "คล้าย JSON" แต่ก็ไม่ใช่ JSON โดยตรง เนื่องจากมีออบเจ็กต์ LatLng อยู่โดยอ้อม

พร็อพเพอร์ตี้
address_components	ประเภท:  Array<GeocoderAddressComponent> อาร์เรย์ของ GeocoderAddressComponent
formatted_address	ประเภท:  string สตริงที่มีที่อยู่ที่มนุษย์อ่านได้ของสถานที่นี้
geometry	ประเภท:  GeocoderGeometry ออบเจ็กต์ GeocoderGeometry
place_id	ประเภท:  string รหัสสถานที่ที่เชื่อมโยงกับสถานที่ตั้ง รหัสสถานที่จะระบุสถานที่ในฐานข้อมูล Google Places และใน Google Maps โดยไม่ซ้ำกัน ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ในคู่มือนักพัฒนาซอฟต์แวร์ Places API
types	ประเภท:  Array<string> อาร์เรย์ของสตริงที่ระบุประเภทขององค์ประกอบที่แปลงเป็นพิกัดภูมิศาสตร์ที่แสดงผล ดูรายการสตริงที่เป็นไปได้ได้ที่ส่วน ประเภทคอมโพเนนต์ของที่อยู่ในคู่มือสำหรับนักพัฒนาซอฟต์แวร์
address_descriptor optional	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น ประเภท:  AddressDescriptor optional คำอธิบายเชิงสัมพันธ์ของสถานที่ที่เชื่อมโยงกับรหัสพิกัดภูมิศาสตร์นี้ ประกอบด้วยชุดจุดสังเกตที่อยู่ใกล้เคียงซึ่งจัดอันดับไว้และพื้นที่ที่มีสถานที่เป้าหมาย ระบบจะป้อนข้อมูลนี้สำหรับคำขอการแปลงพิกัดเป็นชื่อและคำขอการค้นหารหัสสถานที่เท่านั้น เมื่อเปิดใช้ ExtraGeocodeComputation.ADDRESS_DESCRIPTORS และสำหรับสถานที่ที่แปลแล้วบางแห่งเท่านั้น
partial_match optional	ประเภท:  boolean optional ไม่ว่า Geocoder จะไม่แสดงผลการจับคู่ที่ตรงกันทุกประการสำหรับคำขอเดิม แม้ว่าจะจับคู่ส่วนหนึ่งของที่อยู่ที่ขอได้ก็ตาม หากตรงกันทุกประการ ค่าจะเป็น undefined
plus_code optional	ประเภท:  PlacePlusCode optional Plus Code ที่เชื่อมโยงกับสถานที่
postcode_localities optional	ประเภท:  Array<string> optional อาร์เรย์ของสตริงที่ระบุสถานที่ทั้งหมดที่อยู่ในรหัสไปรษณีย์ ซึ่งจะปรากฏเฉพาะเมื่อผลการค้นหาเป็นรหัสไปรษณีย์ที่มีหลายพื้นที่

AddressDescriptor interface

google.maps.AddressDescriptor อินเทอร์เฟซ

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น

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

พร็อพเพอร์ตี้
areas	ประเภท:  Array<Area> รายการพื้นที่ที่อยู่หรือติดกันที่จัดอันดับแล้ว ระบบจะจัดอันดับพื้นที่ที่มีประโยชน์มากที่สุด (จดจำได้และแม่นยำ) เป็นอันดับแรก
landmarks	ประเภท:  Array<Landmark> รายการจุดสังเกตที่อยู่ใกล้เคียงที่จัดอันดับแล้ว จุดสังเกตที่มีประโยชน์มากที่สุด (จดจำได้และอยู่ใกล้เคียง) จะได้รับการจัดอันดับเป็นอันดับแรก

GeocoderAddressComponent อินเทอร์เฟซ

google.maps.GeocoderAddressComponent อินเทอร์เฟซ

คอมโพเนนต์ที่อยู่เดียวภายใน GeocoderResult ที่อยู่แบบเต็มอาจประกอบด้วยคอมโพเนนต์ที่อยู่หลายรายการ

พร็อพเพอร์ตี้
long_name	ประเภท:  string ข้อความทั้งหมดของคอมโพเนนต์ที่อยู่
short_name	ประเภท:  string ข้อความแบบย่อของคอมโพเนนต์ที่อยู่
types	ประเภท:  Array<string> อาร์เรย์ของสตริงที่ระบุประเภทของคอมโพเนนต์ที่อยู่นี้ ดูรายการประเภทที่ถูกต้องได้ที่นี่

GeocoderGeometry อินเทอร์เฟซ

google.maps.GeocoderGeometry อินเทอร์เฟซ

ข้อมูลเรขาคณิตเกี่ยวกับ GeocoderResult นี้

พร็อพเพอร์ตี้
location	ประเภท:  LatLng พิกัดละติจูด/ลองจิจูดของผลการค้นหานี้
location_type	ประเภท:  GeocoderLocationType ประเภทสถานที่ตั้งที่แสดงใน location
viewport	ประเภท:  LatLngBounds ขอบเขตของวิวพอร์ตที่แนะนำสำหรับการแสดง GeocoderResult นี้
bounds optional	ประเภท:  LatLngBounds optional ขอบเขตที่แน่นอนของ GeocoderResult นี้ (หากมี)

GeocoderLocationType ค่าคงที่

google.maps.GeocoderLocationType ค่าคงที่

อธิบายประเภทสถานที่ตั้งที่แสดงจากรหัสพิกัดภูมิศาสตร์ ระบุค่าเหล่านี้ตามค่าหรือโดยใช้ชื่อของค่าคงที่ เช่น 'ROOFTOP' หรือ google.maps.GeocoderLocationType.ROOFTOP

เข้าถึงได้โดยโทรไปที่ const {GeocoderLocationType} = await google.maps.importLibrary("geocoding")
ดูไลบรารีใน Maps JavaScript API

ค่าคงที่
APPROXIMATE	ผลลัพธ์ที่แสดงเป็นค่าประมาณ
GEOMETRIC_CENTER	ผลลัพธ์ที่แสดงคือจุดศูนย์กลางทางเรขาคณิตของผลลัพธ์ เช่น เส้น (เช่น ถนน) หรือรูปหลายเหลี่ยม (ภูมิภาค)
RANGE_INTERPOLATED	ผลลัพธ์ที่แสดงจะสะท้อนถึงค่าประมาณ (มักจะอยู่บนถนน) ที่ประมาณค่าระหว่างจุดที่แม่นยำ 2 จุด (เช่น ทางแยก) โดยทั่วไปแล้ว ระบบจะแสดงผลลัพธ์ที่ประมาณค่าเมื่อไม่มีรหัสพิกัดภูมิศาสตร์บนชั้นดาดฟ้าสำหรับที่อยู่ถนน
ROOFTOP	ผลลัพธ์ที่แสดงจะแสดงรหัสพิกัดภูมิศาสตร์ที่แม่นยำ

อินเทอร์เฟซจุดสังเกต

google.maps.Landmark อินเทอร์เฟซ

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น

สถานที่ที่แสดงจุดอ้างอิงสำหรับที่อยู่

พร็อพเพอร์ตี้
display_name	ประเภท:  string ชื่อของสถานที่สำคัญ
display_name_language_code	ประเภท:  string ภาษาของชื่อสถานที่สำคัญ
place_id	ประเภท:  string รหัสสถานที่ของสถานประกอบการพื้นฐานที่ใช้เป็นสถานที่สำคัญ ใช้เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับสถานที่สำคัญผ่านรายละเอียดสถานที่หรือการค้นหา Place ID ได้
spatial_relationship	ประเภท:  SpatialRelationship กำหนดความสัมพันธ์เชิงพื้นที่ระหว่างตำแหน่งเป้าหมายกับสถานที่สำคัญ
straight_line_distance_meters	ประเภท:  number ระยะทางเป็นเส้นตรงระหว่างสถานที่เป้าหมายกับสถานที่สำคัญ
types	ประเภท:  Array<string> ค่าอย่างน้อย 1 ค่าที่ระบุประเภทของผลลัพธ์ที่แสดง โปรดดูรายละเอียดเพิ่มเติมในประเภท
travel_distance_meters optional	ประเภท:  number optional ระยะทางการเดินทางตามเครือข่ายถนนระหว่างสถานที่เป้าหมายกับสถานที่สำคัญ คุณสามารถปล่อยให้ฟิลด์นี้ว่างไว้ได้หากสถานที่สำคัญไม่ได้เชื่อมต่อกับส่วนของเครือข่ายถนนที่เป้าหมายอยู่ใกล้ที่สุด หรือหากระบบไม่ได้พิจารณาว่าตำแหน่งเป้าหมายอยู่บนเครือข่ายถนน

พื้นที่ อินเทอร์เฟซ

google.maps.Area อินเทอร์เฟซ

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น

สถานที่ที่เป็นภูมิภาคขนาดเล็ก เช่น ย่านใกล้เคียง เขตย่อย หรือคอมเพล็กซ์ขนาดใหญ่ที่มีสถานที่เป้าหมาย

พร็อพเพอร์ตี้
containment	ประเภท:  Containment กำหนดความสัมพันธ์เชิงพื้นที่ระหว่างตำแหน่งเป้าหมายกับพื้นที่
display_name	ประเภท:  string ชื่อของพื้นที่
display_name_language_code	ประเภท:  string ภาษาของชื่อสำหรับพื้นที่
place_id	ประเภท:  string รหัสสถานที่ของพื้นที่พื้นฐาน ใช้เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับพื้นที่ผ่านรายละเอียดสถานที่หรือการค้นหารหัสสถานที่ได้

Containment ค่าคงที่

google.maps.Containment ค่าคงที่

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น

การแจงนับที่แสดงความสัมพันธ์เชิงพื้นที่ระหว่างพื้นที่กับสถานที่ตั้งเป้าหมาย

เข้าถึงได้โดยโทรไปที่ const {Containment} = await google.maps.importLibrary("geocoding")
ดูไลบรารีใน Maps JavaScript API

ค่าคงที่
NEAR	สถานที่เป้าหมายอยู่นอกภูมิภาค แต่ใกล้เคียง
OUTSKIRTS	ตำแหน่งเป้าหมายอยู่ภายในภูมิภาคของพื้นที่ ใกล้กับขอบ
WITHIN	ตำแหน่งเป้าหมายอยู่ภายในภูมิภาคพื้นที่ ใกล้กับศูนย์กลาง

SpatialRelationship ค่าคงที่

google.maps.SpatialRelationship ค่าคงที่

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น

การแจงนับที่แสดงความสัมพันธ์ในพื้นที่ระหว่างจุดสังเกตกับเป้าหมาย

เข้าถึงได้โดยโทรไปที่ const {SpatialRelationship} = await google.maps.importLibrary("geocoding")
ดูไลบรารีใน Maps JavaScript API

ค่าคงที่
ACROSS_THE_ROAD	เป้าหมายอยู่ตรงข้ามกับสถานที่สำคัญบนอีกฝั่งของถนน
AROUND_THE_CORNER	ไม่ได้อยู่บนเส้นทางเดียวกับสถานที่สำคัญ แต่เลี้ยวเพียงครั้งเดียวก็ถึง
BEHIND	ใกล้กับโครงสร้างของสถานที่สำคัญ แต่ไกลจากจุดเข้าถึง
BESIDE	เป้าหมายอยู่ติดกับสถานที่สำคัญโดยตรง
DOWN_THE_ROAD	ในเส้นทางเดียวกับสถานที่สำคัญ แต่ไม่อยู่ข้างหรือตรงข้าม
NEAR	นี่คือความสัมพันธ์เริ่มต้นเมื่อไม่มีความสัมพันธ์ที่เฉพาะเจาะจงกว่านี้ด้านล่าง
WITHIN	สถานที่สำคัญมีเรขาคณิตเชิงพื้นที่และเป้าหมายอยู่ภายในขอบเขต