Câu hỏi thường gặp về mã hóa địa lý

Câu hỏi thường gặp này bao gồm các câu hỏi dành riêng cho API mã hóa địa lý. Vui lòng tham khảo phần Câu hỏi thường gặp về Nền tảng Google Maps để biết những câu hỏi phổ biến cho tất cả Nền tảng Google Maps. Xem thêm Các phương pháp hay nhất khi mã hoá địa chỉ địa lý.

Khắc phục sự cố

Khắc phục sự cố

Tôi đang nhận được thêm nhiều truy vấn trả về ZERO_RESULTS bằng bộ mã hoá địa lý. Điều gì đang xảy ra?

Trong bộ mã hoá địa lý, các truy vấn không rõ ràng, không hoàn chỉnh và có định dạng không hợp lệ (chẳng hạn như địa chỉ bị viết sai chính tả hoặc không tồn tại) dễ dẫn đến ZERO_RESULTS. Nếu không tìm thấy địa chỉ, thì ZERO_RESULTS sẽ phù hợp hơn để lấy một phần kết quả (ví dụ: chỉ trả về vùng ngoại ô thay vì trả về địa chỉ).

Nếu ứng dụng của bạn xử lý dữ liệu do người dùng nhập vào các địa chỉ, thì tính năng Tự động hoàn thành địa điểm trong API Địa điểm có thể tạo ra kết quả chất lượng tốt hơn. Tính năng Tự động hoàn thành theo địa điểm cho phép người dùng chọn trong một tập hợp kết quả dựa trên nội dung họ đã nhập. Nhờ đó, người dùng có thể chọn giữa các kết quả có tên tương tự nhau và điều chỉnh cụm từ tìm kiếm nếu nhập sai địa chỉ.

Nếu ứng dụng của bạn xử lý các truy vấn hoặc truy vấn không rõ ràng hoặc không hoàn chỉnh và có thể có lỗi, bạn nên sử dụng tính năng Place bé (Tự động hoàn thành địa điểm) trong Places API thay vì bộ mã hoá địa lý chuyển tiếp có trong API mã hoá địa lý. Để biết thêm chi tiết, hãy xem Các phương pháp hay nhất khi mã hoá địa chỉ địa chỉ và Địa chỉ mã hoá địa lý trong bài đăng trên blog về API Google Maps.

Tôi cần phản hồi nhanh và bộ mã hoá địa lý quá chậm đối với ứng dụng của tôi. Tôi có thể sử dụng công cụ nào để được phản hồi nhanh hơn?

Các ứng dụng phản hồi hoạt động đầu vào của người dùng và do đó đặc biệt nhạy về độ trễ nên sử dụng tính năng Địa điểm tự động hoàn thành trong API Địa điểm (cũng có trong JavaScript, Android hoặc iOS) thay vì mã hoá địa lý địa chỉ. Tính năng Tự động hoàn thành theo địa điểm được tối ưu hoá để sử dụng theo cách tương tác và do đó có độ trễ rất thấp.

Mã hoá địa lý địa chỉ trong API mã hoá địa lý được tối ưu hoá để sử dụng với các địa chỉ hoàn chỉnh, rõ ràng và được định dạng đúng, chẳng hạn như địa chỉ giao hàng được nhập vào các biểu mẫu trực tuyến và do đó có độ trễ cao hơn tính năng Tự động hoàn thành của địa điểm. Bộ mã hoá địa lý chuyển tiếp có phạm vi bao phủ lớn hơn và chất lượng kết quả tốt hơn, nhưng với độ trễ cao hơn một chút.

Làm cách nào để giảm thiểu độ trễ trên API Chỉ dẫn và API ma trận khoảng cách?

Thay vì địa chỉ, hãy sử dụng mã địa điểm để chỉ định điểm tham chiếu, điểm khởi hành và điểm đến. Bạn nên lấy mã địa điểm từ tính năng Tự động hoàn thành địa điểm trong API Địa điểm hoặc thư viện Địa điểm trong API JavaScript của Maps. Bạn cũng có thể xem thông tin về tuỳ chọn placeIdOnly (có thể dùng để giảm chi phí của tính năng Tự động hoàn thành theo địa điểm).

Khi truy vấn API chỉ dẫn hoặc API ma trận khoảng cách bằng một chuỗi địa chỉ thay vì mã địa điểm hoặc latlng, các API này sử dụng cùng một phần phụ trợ như API mã hoá địa lý để chuyển đổi địa chỉ đó thành mã địa điểm trước khi tính toán đường đi. Tính năng Tự động hoàn thành theo địa điểm nhanh hơn mã hoá địa lý địa chỉ. Đối với các ứng dụng sử dụng API chỉ dẫn hoặc API ma trận khoảng cách trong những tình huống đặc biệt nhạy cảm về độ trễ, chẳng hạn như phản hồi thông tin người dùng nhập, bạn nên sử dụng tính năng Tự động hoàn thành địa điểm để lấy mã địa điểm tương ứng với các địa chỉ đó và truyền mã địa điểm đến API chỉ dẫn hoặc API ma trận khoảng cách. Phương pháp này giúp giảm đáng kể độ trễ. Hãy xem tài liệu của chúng tôi về một ví dụ về cách sử dụng tính năng Tự động hoàn thành địa điểm có chỉ đường.

Làm cách nào để báo cáo lỗi trong bộ mã hoá địa lý?

Nếu bạn có bất kỳ báo cáo lỗi hoặc yêu cầu về tính năng nào cho dịch vụ bộ mã hoá địa lý chuyển tiếp, vui lòng cho chúng tôi biết bằng cách sử dụng công cụ theo dõi lỗi công khai của chúng tôi.

Bộ mã hoá địa lý không tạo ra kết quả tốt cho trường hợp sử dụng của tôi. Họ có thể sử dụng dịch vụ trợ giúp nào?

Vui lòng dùng công cụ theo dõi lỗi công khai và chia sẻ một số cụm từ tìm kiếm cụ thể để chúng tôi có thể điều tra xem liệu có lỗi hoặc vấn đề hệ thống nào gây ra vấn đề về chất lượng kết quả hay không, hoặc có thay đổi gì không trong hướng dẫn về các phương pháp hay nhất nhằm giúp nhà phát triển đạt được kết quả tốt hơn.

Làm cách nào để nhận được kết quả tốt nhất với bộ mã hoá địa lý khi sử dụng tính năng lọc thành phần?

Trong bộ mã hoá địa lý, việc lọc thành phần chỉ thực thi các hạn chế postal_code và country. Những ví dụ sau đây minh hoạ cách tốt nhất để sử dụng tính năng lọc thành phần, tuỳ thuộc vào kết quả bạn cần. Trong các URL yêu cầu mẫu, hãy nhớ thay thế "YOUR_API_KEY" bằng khoá API thực của bạn.

  • Để hạn chế mã bưu chính ở một quốc gia cụ thể, hãy nhớ nêu rõ quy định hạn chế theo quốc gia bằng mã quốc gia theo ISO 3166-2. Ví dụ: components=country:CH|postal_code:8000 trả về "8000 Zürich, Thụy Sĩ". 
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
  • Để hạn chế cụm từ tìm kiếm ở một quốc gia cụ thể, hãy nhớ chỉ định quy định hạn chế theo quốc gia bằng mã quốc gia theo ISO 3166-2. Tên quốc gia và chữ viết tắt khác không đảm bảo sẽ mang lại kết quả giống như mã quốc gia.

    Ví dụ:

    • Việc mã hoá địa lý cho components=country:FRA|locality:gallus trả về cụm dân cư của Gallus ở Frankfurt am Main, Đức. Điều này là do mã quốc gia gồm 3 chữ cái của Pháp (FRA) không được hỗ trợ. Do đó, hệ thống sẽ chấp nhận kết quả tại bất kỳ quốc gia nào và kết quả tại Frankfurt sẽ phù hợp hơn so với tại Pháp. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • API mã hoá địa lý không nhất thiết trả về nhiều kết quả cho các truy vấn không rõ ràng. Nhờ tính năng Tự động hoàn thành theo địa điểm, những truy vấn như vậy sẽ được trả lời chính xác hơn.

    Ví dụ:

    • Mã hoá địa lý cho components=country:US|locality:madrid trả về "Madrid, NM 87010, USA" nhưng không có thành phố nào khác ở Hoa Kỳ có tên là "Madrid". 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • Việc sử dụng tính năng Tự động hoàn thành theo địa điểm cho input=madrid&components=country:us&types=(regions), đồng thời chỉ định một khung nhìn bằng location và radius để làm sai lệch kết quả vị trí, sẽ tạo ra một phản hồi có tên là "Madrid" tại một số thành phố ở Hoa Kỳ. 
      https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=madrid&components=country:us&types=(regions)&key=YOUR_API_KEY