使用Python?想要對某些內容進行地理編碼嗎?尋找路線?也許方向矩陣?該程式庫將 Google Maps Platform Web 服務引入您的 Python 應用程式。
Google 地圖服務的 Python 用戶端是用於以下 Google 地圖 API 的 Python 用戶端程式庫:
請記住,透過此程式庫存取 API 時,相同的條款和條件適用於 API 的使用。
該庫是社區支持的。我們對該庫的穩定性和功能非常滿意,我們希望您可以在其上建立真正的生產應用程式。我們將嘗試透過 Stack Overflow 支援庫的公共和受保護表面,並在未來保持向後相容性;然而,雖然該庫是 0.x 版本,但我們保留進行向後不相容更改的權利。如果我們確實刪除了某些功能(通常是因為存在更好的功能或該功能被證明不可行),我們的目的是棄用並給開發人員一年的時間來更新他們的程式碼。
如果您發現錯誤或有功能建議,請記錄問題。如果您想貢獻,請閱讀貢獻。
每個 Google 地圖 Web 服務請求都需要 API 金鑰或客戶端 ID。 API 金鑰在 Google Cloud 控制台「API 和服務」標籤的「憑證」頁面中產生。
有關 Google Maps Platform 入門和生成/限制 API 密鑰的更多信息,請參閱我們文檔中的 Google Maps Platform 入門。
重要提示:此密鑰應在您的伺服器上保密。
$ pip install -U googlemaps
請注意,如果要指定連線/讀取逾時,則需要 requests 2.4.0 或更高版本。
此範例使用地理編碼 API 和帶有 API 金鑰的方向 API:
import googlemaps
from datetime import datetime
gmaps = googlemaps . Client ( key = 'Add Your Key here' )
# Geocoding an address
geocode_result = gmaps . geocode ( '1600 Amphitheatre Parkway, Mountain View, CA' )
# Look up an address with reverse geocoding
reverse_geocode_result = gmaps . reverse_geocode (( 40.714224 , - 73.961452 ))
# Request directions via public transit
now = datetime . now ()
directions_result = gmaps . directions ( "Sydney Town Hall" ,
"Parramatta, NSW" ,
mode = "transit" ,
departure_time = now )
# Validate an address with address validation
addressvalidation_result = gmaps . addressvalidation ([ '1600 Amphitheatre Pk' ],
regionCode = 'US' ,
locality = 'Mountain View' ,
enableUspsCass = True )
# Get an Address Descriptor of a location in the reverse geocoding response
address_descriptor_result = gmaps . reverse_geocode (( 40.714224 , - 73.961452 ), enable_address_descriptor = True )
有關更多使用範例,請查看測試。
發生間歇性故障時自動重試。也就是說,當從 API 傳回任何可重試的 5xx 錯誤時。
# Installing nox
$ pip install nox
# Running tests
$ nox
# Generating documentation
$ nox -e docs
# Copy docs to gh-pages
$ nox -e docs && mv docs/_build/html generated_docs && git clean -Xdi && git checkout gh-pages
google-maps-services-python
庫的文檔