Geocoder

คลาส Geocoder

google.maps.Geocoder คลาส
ไลบรารี "geocoding"

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

const {Geocoder} = await google.maps.importLibrary("geocoding");

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

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

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

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

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

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

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

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

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

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

ค่าคงที่ ExtraGeocodeComputation

google.maps.ExtraGeocodeComputation ค่าคงที่
ไลบรารี "geocoding"

ประกาศ: ใช้ได้เฉพาะในเวอร์ชันเบต้าเท่านั้น

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

ค่าคงที่เหล่านี้ยังใช้เป็นสตริงได้ด้วย ใน TypeScript สตริงลิเทอรัลจะกำหนดโดยประเภท ExtraGeocodeComputationString

const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding");

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

ค่าคงที่ GeocoderStatus

google.maps.GeocoderStatus ค่าคงที่
ไลบรารี "geocoding"

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

ค่าคงที่เหล่านี้ยังใช้เป็นสตริงได้ด้วย ใน TypeScript สตริงลิเทอรัลจะกำหนดโดยประเภท GeocoderStatusString

const {GeocoderStatus} = await google.maps.importLibrary("geocoding");

ค่าคงที่
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 ไม่บังคับ	ประกาศ: ใช้ได้เฉพาะในเวอร์ชันเบต้าเท่านั้น ประเภท: AddressDescriptor optional คำอธิบายเชิงความสัมพันธ์ของสถานที่ตั้ง รวมชุดจุดสังเกตใกล้เคียงที่จัดอันดับและพื้นที่ที่มีสถานที่เป้าหมาย ระบบจะป้อนข้อมูลนี้สำหรับคำขอการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับเท่านั้น และเฉพาะเมื่อเปิดใช้ ExtraGeocodeComputation.ADDRESS_DESCRIPTORS
plus_code ไม่บังคับ	ประเภท: 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 ไม่บังคับ	ประกาศ: ใช้ได้เฉพาะในเวอร์ชันเบต้าเท่านั้น ประเภท: AddressDescriptor optional คำอธิบายเชิงสัมพันธ์ของสถานที่ที่เชื่อมโยงกับรหัสพิกัดภูมิศาสตร์นี้ รวมชุดจุดสังเกตใกล้เคียงที่จัดอันดับและพื้นที่ที่มีสถานที่เป้าหมาย ระบบจะป้อนข้อมูลนี้สำหรับคำขอการเข้ารหัสที่อยู่เป็นพิกัดภูมิศาสตร์และการค้นหารหัสสถานที่เท่านั้น โดยจะป้อนข้อมูลเมื่อเปิดใช้ ExtraGeocodeComputation.ADDRESS_DESCRIPTORS และสำหรับสถานที่ที่แปลแล้วบางแห่งเท่านั้น
partial_match ไม่บังคับ	ประเภท: boolean optional โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์ไม่ได้แสดงผลลัพธ์ที่ตรงทั้งหมดกับคำขอเดิม แม้ว่าจะจับคู่ที่อยู่บางส่วนที่ขอได้ก็ตาม หากตรงกันทั้งหมด ค่าจะเป็น undefined
plus_code ไม่บังคับ	ประเภท: PlacePlusCode optional Plus Code ที่เชื่อมโยงกับสถานที่ตั้ง
postcode_localities ไม่บังคับ	ประเภท: 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 ไม่บังคับ	ประเภท: LatLngBounds optional ขอบเขตที่แน่นอนของ GeocoderResult นี้ (หากมี)

ค่าคงที่ GeocoderLocationType

google.maps.GeocoderLocationType ค่าคงที่
ไลบรารี "geocoding"

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

ค่าคงที่เหล่านี้ยังใช้เป็นสตริงได้ด้วย ใน TypeScript สตริงลิเทอรัลจะกำหนดโดยประเภท GeocoderLocationTypeString

const {GeocoderLocationType} = await google.maps.importLibrary("geocoding");

ค่าคงที่
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 ไม่บังคับ	ประเภท: number optional ระยะทางในการเดินทางตามเครือข่ายถนนระหว่างสถานที่เป้าหมายกับจุดสังเกต ข้อมูลนี้อาจไม่มีการป้อนหากจุดสังเกตไม่ได้เชื่อมต่อกับส่วนของเครือข่ายถนนที่เป้าหมายอยู่ใกล้ที่สุด หรือหากระบบไม่ถือว่าสถานที่เป้าหมายอยู่บนเครือข่ายถนนจริงๆ

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

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

ประกาศ: ใช้ได้เฉพาะในเวอร์ชันเบต้าเท่านั้น

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

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

ค่าคงที่การล้อมองค์ประกอบ

google.maps.Containment ค่าคงที่
ไลบรารี "geocoding"

ประกาศ: ใช้ได้เฉพาะในเวอร์ชันเบต้าเท่านั้น

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

ค่าคงที่เหล่านี้ยังใช้เป็นสตริงได้ด้วย ใน TypeScript สตริงลิเทอรัลจะกำหนดโดยประเภท ContainmentString

const {Containment} = await google.maps.importLibrary("geocoding");

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

ค่าคงที่ SpatialRelationship

google.maps.SpatialRelationship ค่าคงที่
ไลบรารี "geocoding"

ประกาศ: ใช้ได้เฉพาะในเวอร์ชันเบต้าเท่านั้น

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

ค่าคงที่เหล่านี้ยังใช้เป็นสตริงได้ด้วย ใน TypeScript สตริงลิเทอรัลจะกำหนดโดยประเภท SpatialRelationshipString

const {SpatialRelationship} = await google.maps.importLibrary("geocoding");

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