API de validación de direcciones con streetlayer -

Hay muchas cosas de nuestra web y comercio electrónico que los consumidores dan por sentado: tipos de pago y validación, tipos de cambio, etc. Uno de los aspectos del comercio electrónico que debería darse cuenta por sentado, tanto desde la perspectiva del desarrollador como del consumidor , es el manejo de direcciones. Nos gustaría pensar que el consumidor ingresa su dirección correctamente, pero si no lo hace, el riesgo es que su experiencia se arruine porque la compañía de envío no encuentra la dirección o, peor aún, una situación en la que el paquete se pierde y usted necesita incurrir en una pérdida al enviarle otro artículo. (suponiendo que prefiera evitar una pelea contenciosa con el consumidor sobre de quién es la culpa del problema).

Por supuesto, el comercio electrónico no es el único motivo para la validación y búsqueda de direcciones. Es posible que desees coordenadas para cargar un mapa de Google, es posible que desees obtener el condado del usuario, es posible que desees obtener información del código postal para el cálculo del impuesto sobre las ventas; los casos de uso son infinitos.streetlayer es el servicio que puede realizar todas las necesidades de validación de direcciones.

Consejos Rapidos

• La API de streetlayer es muy fácil de usar
• Obtener validación de direcciones, autocompletado y codificación geográfica
• Proporciona información de direcciones internacionales.
• streetlayer permite solicitudes JSONP
• Proporciona uso de API HTTPS
• Documentación clara y ejemplos de código.
• Precios muy competitivos

Usando streetlayer

streetlayer ofrece registro gratuito con una generosa asignación de solicitudes para pruebas. Después de registrarse, se le entregará una clave API para comenzar el desarrollo. ¡Echemos un vistazo a las diferentes formas en que puedes usar streetlayer!

streetlayerConsejos de uso

Algunas constantes al usar laAPI streetlayer :

• Todas las solicitudes son solicitudes GET
• Todas las solicitudes requieren un access_keyparámetro clave/valor para la clave API
• Agregar format=1a la cadena de consulta para streetlayer sangrar la respuesta JSON

Validar una dirección

Validar una dirección es el uso más común de las API de direcciones. Confiar en que los consumidores introduzcan información (aparte del pago, que se puede verificar instantáneamente) puede generar problemas. Si va a verificar la información de pago, ¿por qué no verificaría la información de la dirección de entrega si puede?

Una vez que su cliente proporcione su información de dirección a su aplicación web o nativa, el primer paso debe ser verificar esa información, ya que es una solicitud HTTP sencilla que le ahorrará problemas de envío y facturación en el futuro. Envíe la información de su dirección proporcionada a streetlayer con una simple solicitud:

http://apilayer.net/api/validate? clave_acceso = TU CLAVE_ACCESO dirección1 = 767 5th Ave código_postal = 10153 localidad = Nueva York código_país = EE.UU.

En el caso de la verificación de dirección de streetlayer, verá la siguiente respuesta:

{  "validation_status": "valid",  "address_components": {     "country_code_alpha2": "US",     "country_code_alpha3": "USA",     "country": "United States",     "county": "New York County",     "locality": "New York",     "postal_code": "10153",     "region": "New York",     "street": "5 Avenue",     "housenumber": "767",     "neighbourhood": "Midtown"  },  "validation_result": {     "locality": true,     "county": null,     "region": null,     "postal_code": true,     "street": true,     "housenumber": true  },  "formatted_address": [     "5 Avenue 767",     "New York, 10153",     "United States"  ],  "coordinates": {     "latitude": 40.763554,     "longitude": -73.972839  }}

Note the validation_status key’s value ofverified — that confirms that the address is verified as correct. If an addresscannot be verified, you’ll see a unsurevalue.

Autocompleting an Address

In the case that you receive a partial address, or the initial address informationisn’t verified and you want to suggest a verified address with less information, streetlayer lets you dothat:

http://apilayer.net/api/autocomplete    ? access_key = YOUR_ACCESS_KEY     text = 767 5th A       country_code = USA

{  "success": true,  "results": [     {        "address_components": {           "country_code_alpha2": "US",           "country_code_alpha3": "USA",           "country": "United States",           "county": "San Diego County",           "locality": "Chula Vista",           "postal_code": "91910",           "region": "California",           "street": "5th Avenue",           "housenumber": "767",           "neighbourhood": "Mid-Broadway District"        },        "formatted_address": [           "5th Avenue 767",           "Chula Vista, 91910",           "United States"        ],        "coordinates": {           "latitude": 32.622941,           "longitude": -117.081476        }     },     {        "address_components": {           "country_code_alpha2": "US",           "country_code_alpha3": "USA",           "country": "United States",           "county": "New York County",           "locality": "New York",           "postal_code": "10153",           "region": "New York",           "street": "5th Avenue",           "housenumber": "767",           "neighbourhood": "Midtown"        },        "formatted_address": [           "5th Avenue 767",           "New York, 10153",           "United States"        ],        "coordinates": {           "latitude": 40.763528,           "longitude": -73.972801        }     },     [...]

Presenting a different, verified address to users if their address information is unverified is commonplace and very useful — a sign to the customeror user that they can no problemstheir transaction.

Get Address by Coordinates (Reverse Geocode Lookup)

I’ve focused much of this post on eCommerce but addressservices like streetlayer have much more utility. For example, think about retrieving approximate addresses by coordinates. Why coordinates?Think about EXIF data from a photo; you canuseEXIF coordinate data to find and approximate addressof a photo:

http://apilayer.net/api/reverse    ? access_key = YOUR_ACCESS_KEY     latitude = 40.763528       longitude = -73.972801

{  "success": true,  "results": [     {        "address_components": {           "country_code_alpha2": "US",           "country_code_alpha3": "USA",           "country": "United States",           "county": "New York County",           "locality": "New York",           "postal_code": "10153",           "region": "New York",           "street": "5 Avenue",           "housenumber": "767",           "neighbourhood": "Midtown"        },        "formatted_address": [           "5 Avenue 767",           "New York, 10153",           "United States"        ],        "coordinates": {           "latitude": 40.763554,           "longitude": -73.972839        }     },     {        "address_components": {           "country_code_alpha2": "US",           "country_code_alpha3": "USA",           "country": "United States",           "county": "New York County",           "locality": "New York",           "postal_code": "10022",           "region": "New York",           "street": "East 58 Street",           "housenumber": "12",           "neighbourhood": "Midtown"        },        "formatted_address": [           "East 58 Street 12",           "New York, 10022",           "United States"        ],        "coordinates": {           "latitude": 40.763268,           "longitude": -73.972842        }     },          [...]

From thosecoordinates streetlayer provides the approximate address!

True story: in my first year as a professional web developer, a clientwas blaming my employer for her eCommerce site’s shipments not always making it to customers. At the time, there was no streetlayer-like service, so we were relying on customers to properly enter information…and it led to me getting angry phone calls. In the end, streetlayer address verificationhas the potential to save yourselfand your customers from shipment, identity, and other geolocation problems!