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 cụ thể về API mã hoá địa lý. Vui lòng tham khảo Câu hỏi thường gặp về Nền tảng Google Maps để biết các câu hỏi chung 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 lý địa chỉ.

Khắc phục sự cố

Khắc phục sự cố

Tôi đang nhận được 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 đầy đủ và được định dạng sai, chẳng hạn như địa chỉ sai chính tả hoặc không tồn tại, dễ tạo ra ZERO_RESULTS. Nếu không tìm thấy địa chỉ, ZERO_RESULTS tốt hơn một phần kết quả (ví dụ: chỉ trả lại vùng ngoại ô thay vì địa chỉ).

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

Nếu bạn có một ứng dụng 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 có thể chứa lỗi, bạn nên sử dụng Tính năng Tự động hoàn thành địa điểm trong API Địa điểm thay vì bộ mã hoá địa lý chuyển tiếp có sẵn trong API mã hóa địa lý. Để biết thêm thông tin, hãy xem Các phương pháp hay nhất khi mã hoá địa lý địa chỉ và Xử lý Mã hoá địa lý trong bài đăng trên blog về API Google Maps.

Tôi cần phản hồi nhanh nhưng bộ mã hoá địa lý quá chậm đối với ứng dụng của tôi. Những việc có thể Tôi dùng để phản hồi nhanh hơn?

Chúng tôi khuyến khích các ứng dụng phản hồi hoạt động đầu vào của người dùng và do đó nhạy cảm với độ trễ, hãy sử dụng tính năng Tự động hoàn thành về địa điểm trong Places API (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 đị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ã hóa địa lý địa chỉ trong API mã hóa địa lý được tối ưu hóa để sử dụng với địa chỉ hoàn chỉnh, rõ ràng, được định dạng tốt, chẳng hạn như địa chỉ giao hàng được nhập vào biểu mẫu trực tuyến, nên có độ trễ cao hơn tính năng Tự động hoàn thành địa điểm. Bộ mã hoá địa lý chuyển tiếp có mức độ phù hợp cao hơn và chất lượng kết quả tốt hơn, nhưng có độ trễ cao hơn một chút.

Làm cách nào để giảm thiểu độ trễ trên API hướng 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 xuất phát và điểm đến. Mã địa điểm tốt nhất nên được lấy từ Tự động hoàn thành địa điểm trong Places API hoặc Thư viện địa điểm trong API JavaScript cho Maps. Ngoài ra, hãy xem thông tin về placeIdOnly để giảm chi phí Tự động hoàn thành địa điểm.

Khi API hướng dẫn hoặc API ma trận khoảng cách được truy vấn bằng một chuỗi địa chỉ thay vì một mã địa điểm hoặc latlng, chúng sử dụng cùng một phụ trợ là API mã hoá địa lý để chuyển đổi địa chỉ đó thành một mã địa điểm trước khi tính chỉ đường. Tính năng Tự động hoàn thành về địa điểm nhanh hơn địa chỉ mã hóa địa lý. Đối với các ứng dụng sử dụng API hướng dẫn hoặc API Ma trận khoảng cách trong các tình huống nhạy cảm về độ trễ cao, chẳng hạn như khi phản hồi hoạt động đầu vào của người dùng, 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à chuyển mã địa điểm đến API hướng dẫn hoặc API ma trận từ xa. 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 để biết ví dụ về cách sử dụng tính năng Tự động hoàn thành địa điểm kèm thông tin 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áo cáo lỗi hoặc các yêu cầu về tính năng đối với 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.

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. Bạn có thể nhận trợ giúp bằng cách nào?

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, chia sẻ một số truy vấn cụ thể để chúng tôi có thể điều tra nhằm xem liệu có lỗi hoặc vấn đề hệ thống nào gây ra sự cố với kết quả không chất lượng hoặc nếu có bất kỳ thay đổi nào chúng tôi có thể thực hiện đối với hướng dẫn về các phương pháp hay nhất để giúp nhà phát triển đạt được kết quả tốt hơn.

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

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

  • Để hạn chế mã bưu chính cho 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 ISO 3166-2. Ví dụ: components=country:CH|postal_code:8000 trả về "8000 Zürich, Thuỵ Sĩ". 
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
  • Để chỉ cho phép một quốc gia cụ thể truy vấn thông tin, hãy đảm bảo chỉ định quy định hạn chế theo quốc gia bằng cách sử dụng mã quốc gia ISO 3166-2. Quốc gia tên và chữ viết tắt khác không được đảm bảo sẽ mang lại kết quả giống như mã quốc gia.

    Ví dụ:

    • Mã hóa địa lý cho giá trị trả về của components=country:FRA|locality:gallus quận nhỏ của Gallus ở Frankfurt am Main, Đức. Điều này là do mã gồm 3 chữ cái mã quốc gia của Pháp (FRA) không được hỗ trợ, do đó, kết quả ở mọi quốc gia đều được phép và kết quả tại Frankfurt phù hợp hơn bất kỳ công ty nào ở 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 sẽ trả về nhiều kết quả cho các truy vấn không rõ ràng. Chẳng hạn thì tốt hơn là nhờ tính năng Tự động hoàn thành về địa điểm.

    Ví dụ:

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