Geocoder

Geocoder class

google.maps.Geocoder class

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

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

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

เมธอด
geocode	geocode(request[, callback]) พารามิเตอร์:  request:  GeocoderRequest callback:  function(Array<GeocoderResult> optional, GeocoderStatus): void optional ผลลัพธ์:  Promise<GeocoderResponse> จับคู่คำขอกับรหัสพิกัดภูมิศาสตร์

GeocoderRequest interface

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

ข้อกําหนดสําหรับคําขอการแปลงพิกัดภูมิศาสตร์ที่จะส่งไปยัง Geocoder

พร็อพเพอร์ตี้
address optional	ประเภท:  string optional ที่อยู่ที่จะเข้ารหัสพิกัดภูมิศาสตร์ ต้องระบุ address, location และ placeId อย่างใดอย่างหนึ่งเท่านั้น
bounds optional	ประเภท:  LatLngBounds|LatLngBoundsLiteral optional LatLngBounds ภายในที่จะค้นหา ไม่บังคับ
componentRestrictions optional	ประเภท:  GeocoderComponentRestrictions optional คอมโพเนนต์ใช้เพื่อจํากัดผลลัพธ์ให้อยู่ในพื้นที่ที่เฉพาะเจาะจง ตัวกรองประกอบด้วย route, locality, administrativeArea, postalCode, country อย่างน้อย 1 รายการ ระบบจะแสดงเฉพาะผลการค้นหาที่ตรงกับตัวกรองทั้งหมด ค่าตัวกรองรองรับวิธีการแก้ไขการสะกดและการจับคู่บางส่วนแบบเดียวกับคำขอการแปลงที่อยู่เป็นพิกัดภูมิศาสตร์อื่นๆ ไม่บังคับ
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 / ตัวระบุ CLDR 2 อักขระ (ไม่ใช่ตัวเลข) ไม่บังคับ ดูภูมิภาคที่รองรับได้ที่รายละเอียดความครอบคลุมของ Google Maps Platform

GeocoderComponentRestrictions interface

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

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

พร็อพเพอร์ตี้
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 constants

google.maps.ExtraGeocodeComputation constants

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

การคํานวณเพิ่มเติมที่จะทําขณะดําเนินการตามคําขอการแปลงที่อยู่เป็นพิกัดภูมิศาสตร์

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

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

GeocoderStatus constants

google.maps.GeocoderStatus constants

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

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

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

การตอบกลับจากโปรแกรมเปลี่ยนที่อยู่เป็นพิกัดภูมิศาสตร์ที่ Geocoder แสดงรายการ GeocoderResult

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

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

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

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

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 constants

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

การกักเก็บ ค่าคงที่

google.maps.Containment constants

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

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

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

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

SpatialRelationship constants

google.maps.SpatialRelationship constants

หมายเหตุ: ใช้ได้เฉพาะในช่อง 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	สถานที่สำคัญมีเรขาคณิตเชิงพื้นที่และเป้าหมายอยู่ภายในขอบเขต