Geocoder

คลาสพิกัดภูมิศาสตร์

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

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

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

Geocoder
Geocoder()
พารามิเตอร์: ไม่มี
สร้างอินสแตนซ์ใหม่ของ Geocoder ที่ส่งคำขอรหัสพิกัดภูมิศาสตร์ไปยังเซิร์ฟเวอร์ของ Google
geocode
geocode(request[, callback])
พารามิเตอร์: 
ค่าที่ส่งคืน:  Promise<GeocoderResponse>
ระบุพิกัดทางภูมิศาสตร์ให้กับคำขอ

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

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

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

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

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

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

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

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

ค่าคงที่ ExtraGeocodeComputation

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

การคำนวณเพิ่มเติมที่จะดำเนินการในขณะที่กรอกคำขอการระบุพิกัดทางภูมิศาสตร์

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

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

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

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

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

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

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

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

สถานที่ซึ่งเป็นตัวแทนของจุดอ้างอิงสำหรับที่อยู่

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

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

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

ค่าคงที่ ค่าคงที่

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

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

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

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

ค่าคงที่ SpatialRelationship

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

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

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

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