peergum/geodb

为Laravel提供地理数据库和API

1.04-beta 2023-11-30 03:51 UTC

This package is auto-updated.

Last update: 2024-09-30 01:52:26 UTC


README

Logo

Laravel GeoDB

一个为您的网站提供地理信息的Laravel包

当前版本: 1.1;

描述

Laravel GeoDB为您的Laravel应用程序提供了一种简单的方式来列出国家、州、城市及其地理定位或它们的组合,无需实现Google或OpenStreetMaps API。

您可以直接从代码、通过外观或从任何反应视图,使用内部API访问信息。

请注意,数据库使用的空间(约1.6GB用于252个国家的4.5M个城市)可能最终会超过Google每月收取的费用。Google也可能为您提供更好或更准确的结果。

状态

此包正在开发中。请稍后再来。

安装

1. 添加包

在您的Laravel网站文件夹中运行 composer require peergum/geodb "^1.1"

2. 设置包

运行 art migrate 安装geodb表,然后

  • 对于完整安装(所有国家),运行安装脚本:art geodb:installart geodb:install all
  • 对于部分安装(仅几个国家),使用参数运行:例如,运行 art geodb:install fr gb us 安装法国、大不列颠和美国的城市。

根据所选国家数量和大小、您的服务器连接性和速度,下载和安装可能需要几秒钟到很长时间。如果您请求“ALL”大写,则安装将下载和解压缩一个最终大小为1.6GB的文件。如果您使用小写“all”,则将分别要求每个国家文件。所有下载的文件,压缩和解压缩后,都保存在storage/geodb文件夹中,以便将来重新运行。可以使用-U或--update选项强制重新下载所需的国家/文件。

3. 更新缓存

如果您正在使用Inertia,请重新运行 npm run build 以更新您的vite缓存。

4. 检查状态

转到您网站的 /geodb,以确认已加载的国家、州和城市数量。如果您已安装inertia/vue,您还可以使用页面上的城市搜索字段来检查响应时间有多快(取决于您的数据库服务器和连接性)

没有Vue的截图(部分加载):example_1.png

Breeze安装后的截图(部分加载):example_2.png

变更日志

请参阅 此处

许可证Apache2

作者:Phil Hilger,又称“PeerGum”

关于我: